{
  "markdown": "# CodeAlive Skills\n\nAgent skills and Claude Code plugin for [CodeAlive](https://app.codealive.ai) — install via [skills.sh](https://skills.sh/) or as a Claude Code plugin.\n\n## Available Skills\n\n| Skill | Description |\n|-------|-------------|\n| [codealive-context-engine](skills/codealive-context-engine/) | Semantic code search and AI-powered codebase Q&A across indexed repositories |\n\n## Installation\n\n> **Claude Code users:** the recommended installation method is [Option 2 (Plugin)](#option-2-claude-code-plugin) — it includes the skill plus authentication hooks and a code exploration subagent.\n\n### Option 1: Skills (universal — 30+ agents)\n\nWorks with Cursor, GitHub Copilot, Windsurf, Gemini CLI, Codex, Goose, Amp, Roo Code, OpenCode, OpenClaw, and [others](https://agentskills.io/).\n\n```bash\nnpx skills add CodeAlive-AI/codealive-skills@codealive-context-engine\n```\n\nOr copy the `skills/codealive-context-engine` folder into your agent's skills directory:\n\n| Agent | Project scope | User scope |\n|-------|--------------|------------|\n| Claude Code | `.claude/skills/` | `~/.claude/skills/` |\n| Cursor | `.cursor/skills/` | `~/.cursor/skills/` |\n| GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` |\n| Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |\n| Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` |\n| Codex | `.codex/skills/` | `~/.codex/skills/` |\n| Goose | `.goose/skills/` | `~/.config/goose/skills/` |\n| Amp | `.agents/skills/` | `~/.config/agents/skills/` |\n| Roo Code | `.roo/skills/` | `~/.roo/skills/` |\n| OpenCode | `.opencode/skill/` | `~/.config/opencode/skill/` |\n| OpenClaw | `skills/` | `~/.openclaw/skills/` |\n\n### Option 2: Claude Code Plugin\n\nFor Claude Code users, this repository also serves as a plugin marketplace with Claude-specific enhancements.\n\n```\n/plugin marketplace add CodeAlive-AI/codealive-skills\n/plugin install codealive@codealive-marketplace\n```\n\n### Option 3: MCP Server\n\nFor deeper integration, install the [CodeAlive MCP server](https://github.com/CodeAlive-AI/codealive-mcp) — it gives your agent direct access to CodeAlive's tools via the Model Context Protocol. The skill and MCP server complement each other: the MCP server provides tool access, the skill teaches the agent how to use it effectively.\n\n### Option 4: Share the Claude Code plugin with another agent\n\nIf you already use the Claude Code plugin and want Codex CLI, Gemini CLI, or another skill-aware agent to consume the exact same skill files, install the [plugin bridge](tools/plugin-bridge/) — a tiny `launchd` agent (macOS) or `systemd --user` path unit (Linux) that keeps a symlink from the other agent's skills directory into the plugin's versioned cache. It re-links automatically on `claude plugin update`.\n\n```bash\ncd tools/plugin-bridge\n./install-macos.sh\n```\n\nSee [`tools/plugin-bridge/README.md`](tools/plugin-bridge/README.md) for configuration and Linux instructions.\n\n## Setup\n\nAfter installing the skill, run the interactive setup:\n\n```bash\npython setup.py\n```\n\nThis will ask for your [API key](https://app.codealive.ai/settings/api-keys), verify it, and store it securely in your OS credential store.\n\n### API Key Storage\n\nThe API key is resolved in this order:\n\n1. `CODEALIVE_API_KEY` environment variable\n2. OS credential store:\n\n| Platform | Store | Manual command |\n|----------|-------|----------------|\n| macOS | Keychain | `security add-generic-password -a \"$USER\" -s \"codealive-api-key\" -w \"KEY\"` |\n| Linux | Secret Service | `secret-tool store --label=\"CodeAlive API Key\" service codealive-api-key` |\n| Windows | Credential Manager | `cmdkey /generic:codealive-api-key /user:codealive /pass:\"KEY\"` |\n\nThe key is stored once and shared across all agents on the same machine.\n\n**Self-hosted instance:** set `CODEALIVE_BASE_URL` to your deployment origin, for example `https://codealive.yourcompany.com`. The setup script accepts both `https://host` and `https://host/api`, but the origin form is preferred.\n\n## Usage\n\nStart your agent and ask naturally:\n\n- *\"How is authentication implemented?\"*\n- *\"Find the exact regex or string match for this token parser\"*\n- *\"Show me error handling patterns across services\"*\n- *\"Find similar features to guide my implementation\"*\n- *\"Show me who calls this handler and what it depends on\"*\n\nNo special commands needed — the agent picks up the skill automatically.\n\nTo check the installed skill version without authentication or a network request:\n\n```bash\npython skills/codealive-context-engine/scripts/get_version.py\n```\n\n## License\n\nMIT\n",
  "bytes": 4549,
  "sha": "ca2ad2721c0a8252f3431ae4887bf4f4f634615a3607c5ede421c4030f4bc6b4",
  "repo_slug": "codealive-ai/codealive-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_codealive_ai_codealive_skills_codealive__6b043a81/readme"
}