# 10x-cli-setup

Walks a 10xDevs learner through installing and checking @przeprogramowani/10x-cli, sorting out login and course access, then passes the project to a guide skill.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3200 installs · ★ 79
- Author: przeprogramowani
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/przeprogramowani/10x-cli/tree/HEAD/skills/10x-cli-setup/SKILL.md
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/skills/10x-cli-setup

## What it does

This skill handles the setup side of the 10xDevs CLI. It starts by looking for an existing runner: checks what is on `PATH`, reads `10x --version`, and asks the `get`, `sync` and `auth` subcommands for help. A working install stays as it is. No reinstall, no second login.

Next comes a compatibility pass against the bundled reference: which release supports the syntax you need, and whether skill filtering exists yet. When no suitable global CLI is present, the skill offers an `npx` run instead of a system-wide install. One catch: `10x helpers install --tool <chosen-profile>` is unreleased and missing from the current baselines, so confirm it with `helpers --help` on your own runner before relying on it. The npm route checks Node against the package `engines`, which means Node 20 or newer here. A permissions failure gets diagnosed, never fixed with `sudo` or a wiped config.

Login is treated separately from course access, via `auth --status`. When sign-in is needed, you run `auth` yourself in an interactive terminal and finish the magic-link flow over email or Circle. The skill never reads `auth.json` or tokens. The last step is `doctor --json`, which compares the configured tool profile and reports the course edition the project is bound to. Offline, publication and download checks stay open, so a local version readout alone does not mean setup is done.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add przeprogramowani/10x-cli --skill 10x-cli-setup -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/10x-cli-setup/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/10x-cli-setup/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add przeprogramowani/10x-cli --skill 10x-cli-setup -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/10x-cli-setup/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add przeprogramowani/10x-cli --skill 10x-cli-setup -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/10x-cli-setup/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install przeprogramowani/10x-cli 10x-cli-setup
```

2. **Manually: put the files in place**
- File: `.github/skills/10x-cli-setup/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add przeprogramowani/10x-cli --skill 10x-cli-setup -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/przeprogramowani/10x-cli --path skills/10x-cli-setup
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/10x-cli-setup/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add przeprogramowani/10x-cli --skill 10x-cli-setup -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/przeprogramowani/10x-cli/tree/HEAD/skills/10x-cli-setup/SKILL.md

## When to use it
- install `10x-cli` without breaking an existing working setup
- confirm the runner version actually supports skill filtering
- find out why `auth --status` does not confirm course access
- tell an npm permissions error apart from a broken `PATH`
- check the project is bound to the right course edition before the first download

## Example prompts
- Check whether `10x-cli` is installed and show me its version and `auth` help
- Install a compatible runner through `npx` and verify my login, leave the global CLI alone
- Run `doctor --json` and explain which course edition this project is bound to

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [przeprogramowani/10x-cli](https://affpapa.org/en/nevibecode/by/przeprogramowani/10x-cli.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md