qbsm-init

One-shot CLI that wires qb-skill-manager (skills auto-extraction for Claude Code) into any project. After running this, Claude Code in that project can call the qbsm MCP server (SSE, hosted on Fly.io) to record skills demonstrated in the conversation.

Quick start

# 1. Sign up + issue an API token at https://qb-skill-manager.fly.dev/settings/tokens
# 2. Run qbsm-init in your project directory:
npx qbsm-init --api-key qbsm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

That writes three files in your project (all merged idempotently if they already exist):

• .mcp.json — registers qbsm as a remote SSE MCP server
• CLAUDE.md — appends a guidance section so Claude Code knows when to call the tools
• .claude/settings.json — hooks that nudge the agent to call register_skill after package installs

Then start a Claude Code session as usual; the qbsm server appears in claude mcp list.

Options

| Flag | Description | |------|-------------| | --api-key <key> | Required (or interactive prompt). Get at https://qb-skill-manager.fly.dev/settings/tokens | | --server-url <url> | Override server (default https://qb-skill-manager.fly.dev) | | -y, --yes | Non-interactive mode; --api-key becomes required | | --no-hooks | Skip .claude/settings.json hook registration | | --overwrite | Replace existing <qbsm:start>…<qbsm:end> section in CLAUDE.md | | -h, --help | Show help |

Positional [target-path] (default .) lets you point at a sibling directory.

Generated .mcp.json entry

{
  "mcpServers": {
    "qbsm": {
      "type": "sse",
      "url": "https://qb-skill-manager.fly.dev/api/mcp/sse",
      "headers": { "x-api-key": "qbsm_..." }
    }
  }
}

.mcp.json is gitignored by default in Next.js / many templates. Do not commit your API key.

Tools exposed

| Tool | Purpose | |------|---------| | auth_status | Confirm which user the API key resolves to | | register_skill | Record a demonstrated skill (idempotent on category + name) | | update_skill | Adjust proficiency / reason / tags on an existing skill | | list_my_skills | List the user's recent skills |

Tokens

If a token is leaked, revoke it at https://qb-skill-manager.fly.dev/settings/tokens and re-run qbsm-init --api-key <new> to overwrite .mcp.json.