back1ply/agent-skill-loader

**Agent Skill Loader** is a Model Context Protocol (MCP) server that acts as a bridge between your static Claude Code Skills library and dynamic AI agents (like Claude Desktop, Cursor, or any MCP client).
It exposes skills both as **MCP Prompts** (slash commands, zero tool calls needed) and as **MCP Tools** (for programmatic use). Skills are auto-discovered from configured directories and stay live — add a new SKILL.md and the client is notified automatically.
🚀 Features
- **MCP Prompts**: Skills appear as slash commands in clients. No tool call needed to inject them.
- **Live updates**: listChanged notification fires when skills are added or removed (via file watcher).
- **Discovery**: list_skills — scans configured skill directories, with optional search filter.
- **Dynamic Learning**: read_skill — fetches the SKILL.md content.
- **Persistence**: install_skill — copies a skill permanently to your project.
- **Configuration**: manage_search_paths — add/remove skill directories at runtime.
- **Troubleshooting**: debug_info — diagnose configuration and path issues.
🛠️ Setup
Prerequisites
- Node.js >= 18
Option A: Install from npm (Recommended)
Then register in .mcp.json:
Option B: Build from Source
Then register in .mcp.json:
📂 Configuration
The server automatically detects its workspace and aggregates skill paths from:
1. **Default**: %USERPROFILE%\.claude\plugins\cache (Standard location)
2. **Dynamic Config**: skill-paths.json (Located in the project root)
Environment Variables
| Variable | Description |
|----------|-------------|
| MCP_SKILL_PATHS | JSON array or semicolon/comma-separated list of additional skill paths |
| MCP_WORKSPACE_ROOT | Override auto-detected workspace root |
| MCP_NO_WATCH | Set to 1 to disable the file watcher (useful in CI) |
Dynamic Path Management
You do not need to manually edit config files. Use the tool to manage paths at runtime:
- **Add**: manage_search_paths(operation="add", path="F:\\My\\Deep\\Skills")
- **Remove**: manage_search_paths(operation="remove", path="...")
- **List**: manage_search_paths(operation="list") creates/updates skill-paths.json.
🤖 Usage
MCP Prompts (Slash Commands)
If your client supports MCP Prompts (Claude Desktop, Cursor, etc.), skills appear automatically as slash commands. Select a skill from the slash command menu to inject its content directly — no tool calls needed.
Tools
The agent has access to five tools:
- list_skills(query?): Returns a JSON list of available skills. Optional query filters by name/description substring (case-insensitive).
- read_skill(skill_name): Returns the markdown instructions for a skill.
- install_skill(skill_name, target_path?): Copies the skill folder to .agent/skills/ . For security, target_path must be within the current workspace.
- manage_search_paths(operation, path?): Add, remove, or list skill search paths.