improve setup skills command UX and fix rate limiting

- Add @inquirer/prompts for interactive multi-select prompts
- Change skillset selection to multi-select (can install both b2c and b2c-cli)
- Rename github-copilot IDE to vscode for clarity
- Add docsUrl to IDE configs and show documentation links after installation
- Use direct GitHub download URLs instead of API to avoid rate limiting
- Update documentation with new IDE names and flag options

Author: clavery

docs/cli/setup.md

@@ -22,15 +22,15 @@ b2c setup skills [SKILLSET]
 
 | Argument | Description | Default |
 |----------|-------------|---------|
-| `SKILLSET` | Skill set to install: `b2c`, `b2c-cli`, or `all` | `all` |
+| `SKILLSET` | Skill set to install: `b2c` or `b2c-cli` | Prompted interactively |
 
 ### Flags
 
 | Flag | Description | Default |
 |------|-------------|---------|
 | `--list`, `-l` | List available skills without installing | `false` |
 | `--skill` | Install specific skill(s) (can be repeated) | |
-| `--ide` | Target IDE(s) (can be repeated) | Auto-detect |
+| `--ide` | Target IDE(s): claude-code, cursor, windsurf, vscode, codex, opencode, manual | Auto-detect |
 | `--global`, `-g` | Install to user home directory (global scope) | `false` |
 | `--update`, `-u` | Update existing skills (overwrite) | `false` |
 | `--version` | Specific release version | `latest` |
@@ -44,8 +44,8 @@ b2c setup skills [SKILLSET]
 | `claude-code` | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
 | `cursor` | Cursor | `.cursor/skills/` | `~/.cursor/skills/` |
 | `windsurf` | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
-| `github-copilot` | GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` |
-| `codex` | Codex CLI | `.codex/skills/` | `~/.codex/skills/` |
+| `vscode` | VS Code / GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` |
+| `codex` | OpenAI Codex CLI | `.codex/skills/` | `~/.codex/skills/` |
 | `opencode` | OpenCode | `.opencode/skills/` | `~/.config/opencode/skills/` |
 | `manual` | Manual | `.claude/skills/` | `~/.claude/skills/` |
 
@@ -54,50 +54,51 @@ Use `manual` when you want to install to the Claude Code paths without marketpla
 ### Examples
 
 ```bash
-# List all available skills
-b2c setup skills --list
-
-# Interactive installation (auto-detects IDEs)
+# Interactive mode (prompts for skillset and IDEs)
 b2c setup skills
 
-# Install to Cursor (project scope)
-b2c setup skills --ide cursor
+# List available skills in a skillset
+b2c setup skills b2c --list
+b2c setup skills b2c-cli --list
 
-# Install to Cursor (global/user scope)
-b2c setup skills --ide cursor --global
+# Install b2c skills to Cursor (project scope)
+b2c setup skills b2c --ide cursor
 
-# Install to multiple IDEs
-b2c setup skills --ide cursor --ide windsurf
+# Install b2c-cli skills to Cursor (global/user scope)
+b2c setup skills b2c-cli --ide cursor --global
 
-# Install only b2c-cli skills
-b2c setup skills b2c-cli --ide cursor
+# Install to multiple IDEs
+b2c setup skills b2c --ide cursor --ide windsurf
 
 # Install specific skills only
-b2c setup skills --skill b2c-code --skill b2c-webdav --ide cursor
+b2c setup skills b2c-cli --skill b2c-code --skill b2c-webdav --ide cursor
 
 # Update existing skills
-b2c setup skills --ide cursor --update
+b2c setup skills b2c --ide cursor --update
 
-# Non-interactive mode (for CI/CD)
-b2c setup skills --ide cursor --global --force
+# Non-interactive mode (for CI/CD) - skillset required
+b2c setup skills b2c-cli --ide cursor --global --force
 
 # Install a specific version
-b2c setup skills --version v0.1.0 --ide cursor
+b2c setup skills b2c --version v0.1.0 --ide cursor
 
 # Output as JSON
-b2c setup skills --list --json
+b2c setup skills b2c --list --json
 ```
 
 ### Interactive Mode
 
 When run without `--force`, the command provides an interactive experience:
 
-1. Downloads skills from the latest release (or specified version)
-2. Auto-detects installed IDEs
-3. Prompts you to select target IDEs
-4. Shows installation preview
-5. Confirms before installing
-6. Reports results
+1. Prompts you to select skill set(s) (if not provided as argument) - you can select both `b2c` and `b2c-cli`
+2. Downloads skills from the latest release (or specified version)
+3. Auto-detects installed IDEs
+4. Prompts you to select target IDEs
+5. Shows installation preview
+6. Confirms before installing
+7. Reports results
+
+In non-interactive mode (`--force`), the skillset argument is required.
 
 ### Claude Code Recommendation
 
@@ -122,7 +123,6 @@ Use `--ide manual` if you prefer manual installation to the same paths.
 |-----------|-------------|
 | `b2c` | B2C Commerce development patterns and practices |
 | `b2c-cli` | B2C CLI commands and operations |
-| `all` | Both skill sets (default) |
 
 ### Output
 
@@ -136,9 +136,9 @@ Example output:
 ```
 Downloading skills from release latest...
 Detecting installed IDEs...
-Installing 24 skills to Cursor (project)
+Installing 12 skills to Cursor (project)
 
-Successfully installed 24 skill(s):
+Successfully installed 12 skill(s):
   - b2c-code → .cursor/skills/b2c-code/
   - b2c-webdav → .cursor/skills/b2c-webdav/
   ...

docs/guide/agent-skills.md

@@ -107,60 +107,68 @@ claude plugin marketplace remove b2c-developer-tooling
 
 The B2C CLI provides a `setup skills` command that downloads and installs agent skills to any supported IDE.
 
+### Interactive Mode
+
+Run without arguments to interactively select skill sets and IDEs:
+
+```bash
+b2c setup skills
+```
+
+This prompts you to select which skill sets (`b2c`, `b2c-cli`, or both) and which IDEs to install to.
+
 ### List Available Skills
 
 ```bash
-b2c setup skills --list
+b2c setup skills b2c --list
+b2c setup skills b2c-cli --list
 ```
 
 ### Install to Specific IDEs
 
 ::: code-group
 
 ```bash [Project Scope]
-# Install to Cursor (current project only)
-b2c setup skills --ide cursor
+# Install b2c skills to Cursor (current project only)
+b2c setup skills b2c --ide cursor
 
-# Install to Windsurf
-b2c setup skills --ide windsurf
+# Install b2c-cli skills to Windsurf
+b2c setup skills b2c-cli --ide windsurf
 
 # Install to multiple IDEs
-b2c setup skills --ide cursor --ide windsurf
+b2c setup skills b2c --ide cursor --ide windsurf
 ```
 
 ```bash [User Scope]
 # Install globally (available in all projects)
-b2c setup skills --ide cursor --global
+b2c setup skills b2c --ide cursor --global
 
 # Install to GitHub Copilot globally
-b2c setup skills --ide github-copilot --global
+b2c setup skills b2c-cli --ide vscode --global
 ```
 
 :::
 
 ### Install Specific Skills
 
 ```bash
-# Install only certain skills
-b2c setup skills --skill b2c-code --skill b2c-webdav --ide cursor
-
-# Install only b2c-cli skills (not b2c development skills)
-b2c setup skills b2c-cli --ide cursor
+# Install only certain skills from a skillset
+b2c setup skills b2c-cli --skill b2c-code --skill b2c-webdav --ide cursor
 ```
 
 ### Update Existing Skills
 
 ```bash
 # Overwrite existing skills with latest versions
-b2c setup skills --ide cursor --update
+b2c setup skills b2c --ide cursor --update
 ```
 
 ### Non-Interactive Mode
 
-For CI/CD pipelines or scripted installations:
+For CI/CD pipelines or scripted installations, the skillset argument is required:
 
 ```bash
-b2c setup skills --ide cursor --global --force
+b2c setup skills b2c-cli --ide cursor --global --force
 ```
 
 See [Setup Commands](/cli/setup) for full CLI documentation.

packages/b2c-cli/package.json

@@ -12,6 +12,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
     "@oclif/core": "^4",
     "@oclif/plugin-autocomplete": "^3",
     "@oclif/plugin-help": "^6",