Agent Skill Loader MCP server

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: managesearchpaths — 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)

npm install -g agent-skill-loader

Then register in .mcp.json:

"agent-skill-loader": {
  "command": "agent-skill-loader"
}

Option B: Build from Source

git clone https://github.com/back1ply/agent-skill-loader.git
cd agent-skill-loader
npm install
npm run build

Then register in .mcp.json:

"agent-skill-loader": {
  "command": "node",
  "args": ["<path-to-repo>/build/index.js"]
}

📂 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

Dynamic Path Management

You do not need to manually edit config files. Use the tool to manage paths at runtime:

• Add: managesearchpaths(operation="add", path="F:\\My\\Deep\\Skills")
• Remove: managesearchpaths(operation="remove", path="...")
• List: managesearchpaths(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:

Shortened. The full README is on GitHub.