{"id":"e0917d6a-4a70-485a-927c-6ffd46f1c092","slug":"kurokeita-ai-agent","kind":"skill","name":"ai-agent","summary":"","owner":"kurokeita","repoUrl":"https://github.com/kurokeita/ai-agent","license":"GPL-3.0","licenseTier":"strong-copyleft","trust":"community","stars":1,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-01-17T05:42:25.000Z","addedAt":"2026-10-22T00:22:02.002Z","logoUrl":"https://avatars.githubusercontent.com/u/7285399?u=cc9e2fb6f4d035b282e325f168453ab6cf179b80&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["writing"],"tags":[],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-26T01:22:16.519Z","sample":false,"url":"https://conduits.dev/tools/kurokeita-ai-agent","language":"TypeScript","transports":["stdio"],"install":{"npm":"@kurokeita/add-skill"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# @kurokeita/add-skill (AI Manager)\n\n[![build](https://img.shields.io/github/actions/workflow/status/kurokeita/ai-agent/release.yml?branch=main)](https://github.com/kurokeita/ai-agent/actions/workflows/release.yml)\n[![npm version](https://img.shields.io/npm/v/@kurokeita/add-skill)](https://www.npmjs.com/package/@kurokeita/add-skill)\n[![npm downloads](https://img.shields.io/npm/dt/@kurokeita/add-skill)](https://www.npmjs.com/package/@kurokeita/add-skill)\n[![license](https://img.shields.io/npm/l/@kurokeita/add-skill)](https://github.com/kurokeita/ai-agent/blob/main/LICENSE.md)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n[![code style: biome](https://img.shields.io/badge/code_style-biome-60a5fa.svg)](https://biomejs.dev)\n\nCLI to manage and install AI agent skills to various platforms.\n\n## Features\n\n- **List Skills**: View a list of available skills.\n- **Local status**: Check which skills are installed locally.\n- **Add Skills**: Interactively add skills with live search/filtering support.\n- **Remove Skills**: Remove locally installed skills with live search/filtering support.\n- **Install from GitHub**: Install skills directly from GitHub URLs.\n\n## Usage\n\n```bash\npnpx @kurokeita/add-skill --help\n```\n\n### List Skills\n\nList available skills in the repository:\n\n```bash\npnpx @kurokeita/add-skill list skill\n```\n\nList locally installed skills:\n\n```bash\npnpx @kurokeita/add-skill list skill --local\n\n# Pick a scope non-interactively (default: global)\npnpx @kurokeita/add-skill list --local --scope project\npnpx @kurokeita/add-skill list --local --scope both\n```\n\n### Add Skills\n\nStarts an interactive session to select and install skills. Supports live search/filtering as you type.\n\n```bash\npnpx @kurokeita/add-skill add\n\n# Install at project scope (writes under the current directory's\n# `.<platform>/...` paths instead of `~/...`). Project scope is\n# refused at $HOME or outside a git work tree.\npnpx @kurokeita/add-skill add --scope project\n```\n\n### Remove Skills\n\nInteractively select installed skills to remove. Supports live search/filtering as you type.\n\n```bash\npnpx @kurokeita/add-skill remove skill\n\n# Pick a scope non-interactively\npnpx @kurokeita/add-skill remove skill --scope project\npnpx @kurokeita/add-skill remove skill --scope both\n```\n\n### Add a Skill from GitHub\n\nInstall a skill directly from a GitHub URL.\n\n```bash\npnpx @kurokeita/add-skill add skill https://github.com/owner/repo/tree/main/skills/skill-name\n```\n\n## How Installs Work\n\n`add` copies every skill into a single canonical directory:\n\n- **Global scope** → `~/.agents/skills`\n- **Project scope** → `<project-root>/.agents/skills`\n\nAfter copying, `add` can optionally wire each platform you select: it installs a session-start hook (under `.agents/hooks/`) and registers it in that platform's config. On each new session the hook symlinks the canonical `.agents/skills` entries back into the platform's own skills directory, so every tool sees the same set of skills from one source of truth.\n\nA skill can also ship Claude Code hooks in a `hooks/` dir. `hooks/hooks.json` holds the `hooks` object of `.claude/settings.json`, and `${HOOKS_DIR}` in its commands resolves to `.claude/hooks`. When `add` installs a skill that has this manifest, it offers to copy the other files in `hooks/` to `.claude/hooks/` and merge the entries into `.claude/settings.json` (global or project, matching the install scope). `git-commit` uses this to install its `commit-gate.py` hook.\n\n`list` and `remove` operate on the canonical `.agents/skills` dir. Removing a skill also prunes any platform symlink left pointing at it.\n\n## Supported Platforms\n\nThe tables below show where each platform loads skills from. These are the symlink destinations the session-start hook creates.\n\n| Platform | Skills Path |\n| :--- | :--- |\n| Antigravity | `~/.gemini/antigravity/global_skills` |\n| Claude Code | `~/.claude/skills` |\n| Codex | `~/.codex/skills` |\n| Gemini CLI | `~/.gemini/skills` |\n| GitHub Copilot | `~/.copilot/skills` |\n| Windsurf | `~/.codeium/windsurf/skills` |\n\n### Project-scope paths\n\nWhen you pick `--scope project`, the canonical `.agents/` dir and the symlink destinations live under the current working directory instead of `~`. The mapping below uses `<project-root>` to mean `process.cwd()` (no git-toplevel relocation: a monorepo subdirectory installs into that subdirectory, not the repo root).\n\n| Platform | Skills Path |\n| :--- | :--- |\n| Antigravity | `<project-root>/.gemini/antigravity/skills` |\n| Claude Code | `<project-root>/.claude/skills` |\n| Codex | `<project-root>/.codex/skills` |\n| Gemini CLI | `<project-root>/.gemini/skills` |\n| GitHub Copilot | `<project-root>/.copilot/skills` |\n| Windsurf | `<project-root>/.codeium/windsurf/skills` |\n\nProject scope is refused when `cwd` equals your home directory or `cwd` is not inside a git work tree. When refused interactively, you can fall back to global scope without losing your already-selected skills and platforms.\n\n## Development\n\n1. **Clone the repository:**\n\n    ```bash\n    git clone https://github.com/kurokeita/ai-agent.git\n    cd ai-agent\n    ```\n\n2. **Install dependencies:**\n\n    ```bash\n    pnpm install\n    ```\n\n3. **Run in development mode:**\n\n    ```bash\n    pnpm dev\n    ```\n\n4. **Lint and Format:**\n\n    ```bash\n    pnpm lint\n    pnpm format\n    ```\n\n5. **Build:**\n\n    ```bash\n    pnpm build\n    ```\n\n## License\n\nThis project is licensed under the [GNU General Public License v3.0](LICENSE.md).\n"}