# aktsmm/skill-ninja-mcp-server [Health: Active] **Category:** 🤖 Coding Agents **Repository:** https://github.com/aktsmm/skill-ninja-mcp-server **GitHub Stars:** 12 **npm Downloads (last month):** 109 **Views:** 2 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/aktsmm-skill-ninja-mcp-server ## Description Agent Skill Ninja for MCP: Search, install, and manage AI agent skills (SKILL.md files) from GitHub repositories. Features workspace analysis for personalized recommendations and supports 140+ pre-indexed skills. ## Tools Capabilities this server exposes over MCP: - **skillNinja_search** — Search for Agent Skills by keyword. Returns matching skills with trust badges and recommendations. / キーワードでエージェントスキルを検索 - **skillNinja_install** — Install an Agent Skill to the workspace. Downloads SKILL.md when source content is resolvable, otherwise generates a minimal stub and updates AGENTS.md. / スキルをワークスペースにインストールし、取得できる場合は SKILL.md を保存、できない場合は最小内容を生成 - **skillNinja_uninstall** — Uninstall an Agent Skill from the workspace. Removes skill folder and updates AGENTS.md. / スキルをアンインストール - **skillNinja_list** — List all installed Agent Skills in the workspace. / インストール済みスキル一覧を表示 - **skillNinja_recommend** — Get skill recommendations based on popularity. / 人気スキルのおすすめを取得 - **skillNinja_updateIndex** — Update the skill index from all registered sources. Fetches latest skills from GitHub repositories. / スキルインデックスを更新 - **skillNinja_webSearch** — Search for Agent Skills on GitHub. Finds SKILL.md files across GitHub repositories. / GitHub でスキルを検索 - **skillNinja_addSource** — Add a new GitHub repository as a skill source. Repository should contain SKILL.md files. / 新しいリポジトリをスキルソースとして追加 - **skillNinja_localize** — Translate/localize skill descriptions in the index. Provide skillName and description_en and/or description_ja. / スキル説明を翻訳・ローカライズ ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "skill-ninja-mcp-server": { "command": "npx", "args": ["-y","skill-ninja-mcp-server"], "env": { "GITHUB_TOKEN": "", "SKILL_NINJA_INDEX_DIR": "", "SKILL_NINJA_TRUSTED_WORKSPACES": "", "LANG": "" } } } ``` **Requires environment variables:** `GITHUB_TOKEN`, `SKILL_NINJA_INDEX_DIR`, `SKILL_NINJA_TRUSTED_WORKSPACES`, `LANG` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for). ## Documentation & README # Skill Ninja MCP Server 🥷 [![npm version](https://img.shields.io/npm/v/skill-ninja-mcp-server.svg)](https://www.npmjs.com/package/skill-ninja-mcp-server) [![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](LICENSE) Skill Ninja MCP Server on Glama [日本語版 README](https://github.com/aktsmm/skill-ninja-mcp-server/blob/HEAD/README_ja.md) An MCP (Model Context Protocol) server for searching, installing, and managing AI Agent Skills. Works with MCP-compatible clients like Claude Desktop, Cursor, and VS Code. ## Installation ```bash npm install -g skill-ninja-mcp-server ``` Or run it directly with npx: ```bash npx skill-ninja-mcp-server ``` ## Configuration ### Claude Desktop `~/.claude/claude_desktop_config.json`: ```json { "mcpServers": { "skill-ninja": { "command": "npx", "args": ["skill-ninja-mcp-server"] } } } ``` ### VS Code (mcp.json) `%APPDATA%\Code\User\mcp.json`: ```json { "servers": { "skill-ninja": { "command": "npx", "args": ["skill-ninja-mcp-server"] } } } ``` ## Environment Variables | Variable | Description | Default | | -------------------------------- | --------------------------------------------------------- | ------------------------------------- | | `GITHUB_TOKEN` | GitHub API token for higher rate limits | none | | `SKILL_NINJA_INDEX_DIR` | Skill index storage directory | `~/.skill-ninja` | | `SKILL_NINJA_TRUSTED_WORKSPACES` | Trusted workspace roots allowed for read/write operations | auto-detect current project root only | | `LANG` | Output language, for example `ja_JP` | system default | ## Security Workspace-mutating tools only operate inside trusted workspace roots. - By default, the server trusts the current working directory only when it looks like a project root. - To allow other locations, set the `SKILL_NINJA_TRUSTED_WORKSPACES` environment variable to one or more trusted roots separated by your OS path delimiter. - Requests outside trusted roots are rejected before any read, write, or delete occurs. - GitHub API and raw content fetches use a bounded timeout so network failures return control instead of hanging the MCP server indefinitely. ## Duplicate Skill Names - Search and recommendation results include the source name for each skill. - If multiple sources publish the same skill name, pass the optional `source` field to `skillNinja_install` or `skillNinja_localize`. - Installed skill listings include the recorded source, and the server refuses to overwrite an installed skill with the same name from a different source. - If a partial skill name matches multiple different skills, the install, localize, and uninstall flows now stop and ask for the exact skill name instead of picking the first match. ## Tools | Tool | Description | | ------------------------ | ---------------------------------------------------------- | | `skillNinja_search` | Search the local skill index by keyword | | `skillNinja_install` | Install a skill into a trusted workspace | | `skillNinja_uninstall` | Remove an installed skill from a trusted workspace | | `skillNinja_list` | List installed skills in a trusted workspace | | `skillNinja_recommend` | Recommend skills based on workspace contents | | `skillNinja_updateIndex` | Refresh the local skill index from registered sources | | `skillNinja_webSearch` | Search GitHub for repositories containing `SKILL.md` files | | `skillNinja_addSource` | Add a GitHub repository as a skill source | | `skillNinja_localize` | Update localized skill descriptions in the index | `skillNinja_install` tries to fetch the original `SKILL.md` from the source repository. If the source file cannot be resolved or downloaded, it installs a minimal file generated from the local index and reports that fallback in the result. ## Usage Examples ```text "Find skills for Azure work" -> skillNinja_search "Install the webapp-testing skill from GitHub Awesome Copilot" -> skillNinja_install with skillName="webapp-testing" and source="github-awesome-copilot" "Install test" -> refine to the exact skill name first, for example "test-driven-development" "Search GitHub for MCP skills" -> skillNinja_webSearch ``` ## Development ```bash git clone https://github.com/aktsmm/skill-ninja-mcp-server cd skill-ninja-mcp-server npm install npm test npm run release:verify ``` ## License CC BY-NC-SA 4.0 — see [LICENSE](https://github.com/aktsmm/skill-ninja-mcp-server/blob/HEAD/LICENSE).