# Context8 Skill Pack

Use this file as a quick-start skill prompt for coding agents.

## Cloud Server Skill (Zero-to-One)

1. Verify Node.js and npm are installed.
2. Install MCP runtime:
   - `npm install -g context8-mcp`
   - fallback: `npx -y context8-mcp`
3. Ask user for:
   - MCP client type (Cursor, Codex CLI, Claude Code, VS Code, etc.)
   - API key (optional, but required for write/private access)
4. Configure remote endpoint:
   - Always use `--remote-url` (not `--url`)
   - Always include protocol: `https://api.context8.org`
   - Example with key:
     `context8-mcp remote-config --remote-url https://api.context8.org --api-key <key>`
   - Example without key (public read-only):
     `context8-mcp remote-config --remote-url https://api.context8.org`
5. Access policy:
   - No API key: public search only.
   - No API key: do not create/update/delete solutions.
6. Verify:
   - `context8-mcp diagnose`
   - key mode: `context8-mcp list --limit 1`
   - no-key mode: `context8-mcp search-solutions "redis timeout" --limit 5`
7. If diagnose shows parse URL errors, fix URL first (missing protocol).
   - optional checks:
     - `nslookup api.context8.org`
     - `curl https://api.context8.org/status`

## Docker Self-hosted Skill (Zero-to-One)

1. Bootstrap stack:
   - `./scripts/configure_context8_docker.sh --up --smoke`
2. Install MCP bridge:
   - `npm install -g context8-mcp`
3. Configure bridge with local API key:
   - `context8-mcp remote-config --remote-url http://localhost:8000 --api-key <key>`
4. Verify bridge:
   - `context8-mcp diagnose`
   - `context8-mcp list --limit 1`