Agent Skill Ninja 🥷

Search, Install, and Manage Agent Skills for AI Coding Assistants

GitHub Copilot • Claude Code • Cursor • Windsurf • Cline

Features • Installation • Usage • Copilot Chat • Settings • Development

🇯🇵 日本語版はこちら

Features

🔍 Skill Search & Discovery

• Search 100+ skills by keyword (local & GitHub)
• Multi-keyword Search - Scored by name, path, description relevance
• Parallel Fetch - Fast results with 50 concurrent requests
• Fallback Search - Auto-retry with fewer keywords if no results
• Search results with descriptions & category tags
• ⭐ Star counts & organization badges
• Install / Preview / Favorite directly from search results

📦 Install & Manage

• One-click installation to .github/skills/
• Auto-update instruction file (AGENTS.md / copilot-instructions.md / CLAUDE.md)
• Table Format - Skills displayed in table with "When to Use" column
• Auto-extract "When to Use" - Extracted from SKILL.md ## When to Use section
• Edit Description - Right-click to customize skill description
• Uninstall functionality
• Reinstall All - Batch reinstall from latest source (with auto index update)
• Install Feedback - 🆕 badge, status bar notification, auto-select in tree view
• Open Folder - Quick access to installed skill folder
• Index Integrity Check - Auto-detect missing skills and prompt for index update

� Multi-Tool Support

• Auto-detection of AI tools in workspace (Cursor, Windsurf, Cline, Claude Code, GitHub Copilot)
• Automatic format selection based on detected tool
• Manual override available in settings
• Supported output formats:
• Markdown (AGENTS.md, CLAUDE.md, copilot-instructions.md)
• Cursor Rules (.cursor/rules/)
• Windsurf Rules (.windsurfrules)
• Cline Rules (.clinerules)

�🏠 Local Skill Management

• Auto-detect SKILL.md files anywhere in workspace
• Automatically sync to instruction file (with includeLocalSkills setting)
• Manual register / unregister commands
• Create new skill from template

🤖 GitHub Copilot Chat Integration

• @skill commands for direct chat operations
• /search, /install, /list, /recommend
• Project-based skill recommendations

🛠️ MCP Tools Integration

• Automatically available as tools in Agent Mode
• 8 Tools: #searchSkills, #installSkill, #uninstallSkill, #listSkills, #recommendSkills, #updateSkillIndex, #webSearchSkills, #addSkillSource
• Trust badges (🏢 Official / 📋 Curated / 👥 Community)
• Auto-update instruction file on install

🌍 Multi-language & UI

• Japanese / English UI (auto-detect + manual switch)
• Skill preview in Webview
• Favorites feature

Demo

Installation

VS Code Marketplace

ext install yamapan.agent-skill-ninja

Or search for "Agent Skill Ninja" in VS Code Extensions (Ctrl+Shift+X)

Manual Installation

1. Download .vsix from Releases
2. In VS Code: Ctrl+Shift+P → Extensions: Install from VSIX...
3. Select the downloaded .vsix file

Included Skill Sources

💡 Use Update Index command to fetch the latest skills

Usage

Sidebar Operations

1. Click the spiral shuriken icon in the Activity Bar
2. Workspace Skills - Installed & local skills list
3. ✓ Installed skills (green icon) with source name
4. ○ Local skills (unregistered, yellow icon)
5. 🆕 Newly installed skills (temporary badge)
6. Toolbar: 📄 Instruction File / ➕ Create / 🔃 Refresh / ⚙️ Settings
7. ... Menu: Reinstall All / Uninstall All / Multiple selection
8. 📂 Open skill folder (right-click menu)
9. Remote Skills - Browse skills by source
10. ⭐ Favorites section at top
11. Sources sorted: 🏢 Official → ⭐ Curated → 📦 Community
12. ✓ Shows installed status with green icons
13. One-click install from list

Icon Legend

Command Palette

Quick Start

1. Ctrl+Shift+P → "Agent Skill Ninja: Search Skills"
2. Enter keywords (e.g., "pdf", "azure", "git")
3. Select skill → Choose action (Install / Preview / Favorite / GitHub)
4. Done! Auto-registered in instruction file

Search Tips 💡

📝 If no results found, keywords are automatically reduced and retried.

Copilot Chat

Use @skill in GitHub Copilot Chat for skill operations:

@skill /search MCP server      # Search skills
@skill /install github-mcp     # Install skill
@skill /list                   # List installed
@skill /recommend              # Project-based recommendations
@skill what tools for Python?  # Natural language search

Commands

💡 Search results include install buttons for direct installation

MCP Tools (Agent Mode)

In GitHub Copilot's Agent Mode, tools are automatically available.

Tool List

Usage Examples

💬 "Find Azure-related skills"
   → #searchSkills automatically invoked, displays results

💬 "Install the bicep-mcp skill"
   → #installSkill installs, auto-updates instruction file

💬 "Search GitHub for MCP servers"
   → #webSearchSkills searches GitHub repositories

💬 "What skills would you recommend for this project?"
   → #recommendSkills analyzes workspace and recommends

Features

• 🏢 Trust Badges: Shows Official / Curated / Community
• 🌟 Recommended Skills: Suggests best skills from search results
• 📅 Index Update Info: Shows last update date with warnings if outdated
• ⚙️ Settings Integration: Respects autoUpdateInstruction / includeLocalSkills
• 🎯 Token Efficiency: Save conversation context by using MCP tools

Disable MCP Tools

If you don't need MCP tools, you can disable them from GitHub Copilot Chat:

1. Copilot Chat panel → ⚙️ → Tools
2. Toggle off "Agent Skill Ninja" tools

Settings

💡 Settings are displayed in the order above

Output Format Details

When auto is selected, the extension automatically detects which AI tool is being used based on configuration files in your workspace.

How Instruction File Sync Works

When autoUpdateInstruction is enabled:

1. Install/Uninstall skill → Instruction file is automatically updated
2. Local SKILL.md detected → Added to instruction file (if includeLocalSkills is true)
3. Register/Unregister command → Manual control for local skills

The instruction file contains a managed section:

<!-- skill-ninja-START -->

## Agent Skills

- [skill-name](path/to/SKILL.md) - description
<!-- skill-ninja-END -->

Instruction File Options

GitHub Token Setup

⚠️ Important: GitHub Token is required for GitHub Search. Without it, API rate limits (60 requests/hour) will be exhausted quickly and searches will fail.

Set up a GitHub Token to enable full search functionality:

Option 1: VS Code Settings

Find Agent Skill Ninja: GitHub Token in settings and enter your token:

{
  "skillNinja.githubToken": "ghp_xxxxxxxxxxxx"
}

👉 Create a GitHub Token (Required scopes: repo, read:org)

Option 2: GitHub CLI (Recommended)

gh auth login

💡 If GitHub CLI is installed, the token is automatically retrieved (no configuration needed)

Development

# Install dependencies
npm install

# Compile
npm run compile

# Build in watch mode
npm run watch

# Package
npm run package

# Lint
npm run lint

Debugging

1. Press F5 in VS Code
2. Test the extension in a new VS Code window
3. Run Agent Skill Ninja commands from Command Palette (Ctrl+Shift+P)

Contributing

1. Fork this repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

CC BY-NC 4.0 © yamapan

• Free for non-commercial use, modification, and redistribution
• Commercial use requires permission
• Microsoft employees may use for work purposes

⚠️ Use of this content for AI/ML training, data mining, or other analytical purposes is prohibited.

Related Projects

• anthropics/skills - Official Claude Skills
• github/awesome-copilot - Official Copilot Resources
• ComposioHQ/awesome-claude-skills - Curated Skills List

Author

yamapan (https://github.com/aktsmm)