vikas8520-coder/nerve/cli-skill-collector

Overview

Detect installed CLI coding tools (Claude Code, Codex, Cursor, Copilot, Cline and more), search GitHub for matching agent skills, and install them to the detected tools via Nerve's built-in APIs.

Quick install

npm install -g nerve   # or: npx nerve
nerve --version

Subcommands

autostart

Example:

nerve autostart

autostart enable

Example:

nerve autostart enable

autostart disable

Example:

nerve autostart disable

autostart toggle

Example:

nerve autostart toggle

autostart status

Example:

nerve autostart status

config

Show or update CLI tool configuration

Example:

nerve config

config list

List all CLI tools and config status

Flags:

• --json

Example:

nerve config list

config get <tool>

Show current config for a tool

Flags:

• --json

Example:

nerve config get <tool>

config set <tool>

Write config for a tool

Flags:

• --model <model>
• --non-interactive
• --yes

Example:

nerve config set <tool>

config validate <tool>

Validate config format without writing

Flags:

• --model <model>
• --json

Example:

nerve config validate <tool>

config opencode

Generate OpenCode config (alias for

Flags:

• --model <model>
• --non-interactive
• --yes

Example:

nerve config opencode

config lang

Example:

nerve config lang

config get

Flags:

• --json

Example:

nerve config get

config set <code>

Flags:

• --force

Example:

nerve config set <code>

config list

Flags:

• --json

Example:

nerve config list

env

Show and manage environment variables

Example:

nerve env

env show

Show current environment variables

Flags:

• --json

Example:

nerve env show

env get <key>

Get a single environment variable

Example:

nerve env get <key>

env set <key> <value>

Set an environment variable (current session only)

Example:

nerve env set <key> <value>

setup

Flags:

• --password <value>
• --add-provider
• --provider <id>
• --provider-name <name>
• --api-key <value>
• --default-model <model>
• --provider-base-url <url>
• --test-provider
• --non-interactive
• --list

Example:

nerve setup

update

Flags:

• --check
• --apply
• --changelog
• --dry-run
• --no-backup
• --yes

Example:

nerve update

<!-- skill:custom-start --> <!-- Preserved curated content from #6294 (skills/cli-skill-collector authored workflow) -->

/cli-skill-collector — Agent Skill Collector

Discover and install agent skills for your coding CLI tools — all through Nerve's built-in APIs.

This skill teaches you how to:

1. Detect which coding CLIs are installed on this machine
2. Search GitHub for relevant agent skills (SKILL.md repos)
3. Install discovered skills to the detected coding tools

No separate Skill Collector app needed — Nerve's own CLI detection + GitHub search handles everything.

Step 1 — Detect installed coding tools

Query Nerve's CLI tool detection to find which coding agents are installed:

curl -H "Authorization: Bearer $NERVE_API_KEY" http://localhost:20128/api/skills/collect/detect

This returns:

• Every CLI tool in Nerve's catalog (CLI_TOOL_IDS: claude, codex, cursor, copilot, opencode, cline, kilocode, hermes, hermes-agent, openclaw, droid, continue, qwen, windsurf, devin, antigravity, etc.)
• Whether each is installed and runnable
• GitHub skills matched to your installed tools (scored by relevance)

Example response:

{
  "tools": {
    "codex": { "installed": true, "runnable": true, "command": "codex" },
    "claude": { "installed": true, "runnable": true, "command": "claude" },
    "cursor": { "installed": false, "runnable": false }
  },
  "installedToolIds": ["codex", "claude"],
  "matchedSkills": [
    { "toolId": "codex", "repo": "user/skill-codex-xxx", "score": 0.85, "stars": 120 },
    { "toolId": "claude", "repo": "user/claude-agent-rules", "score": 0.92, "stars": 340 }
  ],
  "totalSkills": 85
}

Step 2 — Review matched skills

For each installed tool, the API returns relevant GitHub repos that contain SKILL.md or agent configuration files. Use the score field to prioritize:

You can also browse manually:

curl -H "Authorization: Bearer $NERVE_API_KEY" \
  "http://localhost:20128/api/github-skills?minStars=3&maxResults=50"

Step 3 — Install skills to detected tools

Install a chosen skill to one or more detected tools:

curl -X POST http://localhost:20128/api/skills/collect/install \
  -H "Authorization: Bearer $NERVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "repoName": "user/skill-codex-xxx",
    "targets": ["codex", "claude"],
    "description": "Agent skill for coding workflows"
  }'

This plans the installation path for each target tool:

• claude → ~/.claude/skills/{category}/
• codex → ~/.codex/skills/{category}/
• hermes → ~/AppData/Local/hermes/skills/{category}/
• opencode → ~/.opencode/skills/{category}/
• gemini → ~/.gemini/skills/{category}/

The actual file sync (cloning from GitHub and copying SKILL.md) is done by the agent using standard curl + cp commands.

Step 4 — Verify installation

After installing, verify the skill is in place:

# For Codex
ls -la ~/.codex/skills/imported-github/*/SKILL.md
 
# For Claude Code
ls -la ~/.claude/skills/imported-github/*/SKILL.md
 
# For Hermes (Windows)
ls -la ~/AppData/Local/hermes/skills/imported-github/*/SKILL.md

Also re-check detection:

curl -H "Authorization: Bearer $NERVE_API_KEY" http://localhost:20128/api/skills/collect/detect

Quick start (full workflow)

AUTH_HEADER="Authorization: Bearer $NERVE_API_KEY"
 
# 1. Detect
DETECT=$(curl -s -H "$AUTH_HEADER" http://localhost:20128/api/skills/collect/detect)
 
# 2. Pick top matched skill for first installed tool
TOOL=$(echo "$DETECT" | python3 -c "import sys,json;d=json.load(sys.stdin);print(d['installedToolIds'][0] if d['installedToolIds'] else '')")
SKILL=$(echo "$DETECT" | python3 -c "import sys,json;d=json.load(sys.stdin);ms=d.get('matchedSkills',[]);print(ms[0]['repo'] if ms else '')")
 
if [ -n "$TOOL" ] && [ -n "$SKILL" ]; then
  # 3. Install
  curl -s -X POST http://localhost:20128/api/skills/collect/install \
    -H "$AUTH_HEADER" \
    -H "Content-Type: application/json" \
    -d "{\"repoName\": \"$SKILL\", \"targets\": [\"$TOOL\"]}"
  echo "Installed $SKILL to $TOOL"
fi

Notes

• Nerve must be running locally on port 20128 (default) — see docs/frameworks/SKILLS.md for custom-port setups.
• The /api/skills/collect/* and /api/github-skills endpoints require management-scoped authentication the same way every other /api/skills/* route does: a dashboard session, the loopback CLI token, or an API key with the manage scope (requireManagementAuth()). Auth is only bypassed when the server has no login/API-key requirement configured at all.
• This replaces the standalone Skill Collector Python app — all logic is now inside Nerve.

<!-- skill:custom-end -->