Agent Skill Loader

by back1ply

373 downloads
Not rated
GitHub

About

MCP server to dynamically load Claude Code skills into AI agents

Details

Author
back1ply
Downloads
373
Categories
Developer Tools, AI

- Scans configured skill directories for discovery.
- Fetches SKILL.md content for agents to read.
- Copies skill permanently to project if needed.
- Adds or removes skill directories at runtime.
- Diagnoses configuration and path issues.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Agent Skill Loader
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install globally via npm (npm install -g agent-skill-loader) and register the server in .mcp.json. Alternatively, build from source. After setup, agents have access to five tools: list_skills, read_skill, install_skill, manage_search_paths, and debug_info.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "agent skill loader": {
            "agent-skill-loader": {
                "command": "npx",
                "args": [
                    "-y",
                    "agent-skill-loader"
                ]
            }
        }
    }
}

McpServers

{
    "agent-skill-loader": {
        "command": "npx",
        "args": [
            "-y",
            "agent-skill-loader"
        ]
    }
}

Agent Skill Loaderis 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 asMCP Prompts(slash commands, zero tool calls needed) and asMCP Tools(for programmatic use). Skills are auto-discovered from configured directories and stay live — add a newSKILL.mdand the client is notified automatically.

- MCP Prompts: Skills appear as slash commands in clients. No tool call needed to inject them.
- Live updates:listChangednotification 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 theSKILL.mdcontent.
- 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.

Option A: Install from npm (Recommended)

"agent-skill-loader": { "command": "agent-skill-loader" }
git clone https://github.com/back1ply/agent-skill-loader.git cd agent-skill-loader npm install npm run build
"agent-skill-loader": { "command": "node", "args": ["<path-to-repo>/build/index.js"] }

The server automatically detects its workspace and aggregates skill paths from:
- Default:%USERPROFILE%\.claude\plugins\cache(Standard location)
- Dynamic Config:skill-paths.json(Located in the project root)

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/updatesskill-paths.json.

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.

- list_skills(query?): Returns a JSON list of available skills. Optionalqueryfilters 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/<name>. For security,target_pathmust be within the current workspace.
- manage_search_paths(operation, path?): Add, remove, or list skill search paths.
- debug_info(): Returns diagnostic information (paths, status, warnings).

"I need to write a DAX measure but I'm not sure about the best practices."

The agent will automatically calllist_skills, findwriting-dax-measures, callread_skill, and answer with expert knowledge. Or the user can invoke the skill directly as a slash command.

If skills aren't being discovered, usedebug_info()to see:

- search_paths: Which directories are being scanned
- path_status: Whether each path exists and is readable
- warnings: Any errors encountered during scanning (permission denied, empty files, etc.)

{ "workspace_root": "C:/projects/agent-skill-loader", "search_paths": { "base": ["C:/Users/pc/.claude/plugins/cache"], "dynamic": ["F:/My/Skills"], "effective": ["C:/Users/pc/.claude/plugins/cache", "F:/My/Skills"] }, "path_status": [ { "path": "C:/Users/pc/.claude/plugins/cache", "exists": true, "readable": true }, { "path": "F:/My/Skills", "exists": false, "readable": false } ], "skills_found": 12, "warnings": [ { "path": "F:/My/Skills", "reason": "Directory does not exist" } ] }

- src/index.ts: Main server logic (tools + prompts + watcher).
- src/utils.ts: Skill scanning, description extraction, prompt helpers, debounce.
- build/: Compiled JavaScript output.
- package.json: Dependencies (@modelcontextprotocol/sdk,chokidar,zod).

To add new skills, add a folder with aSKILL.mdfile to one of the watched directories. The server picks them up automatically and sends alistChangednotification — no restart required.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

Instead of direct calling MCP tools, mcpcode server transforms MCP tool calls into TypeScript programs, enabling smarter, lower-latency orchestration by LLMs.

Supercharge your Agent with Semantic Code Intelligence and save 💰 in the process!

AI-to-AI code review platform — Claude, Codex, and Gemini cross-check each other via MCP, REST API, and CLI for consensus-based results.

A code sandbox for AI assistants to safely execute arbitrary code. Requires a 302AI API key for authentication.

Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.

MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) — purpose-built tools, model routing with fallback, session continuity, and output truncation to save Claude's context and tokens.

Exposes local execution of Aider commands as a detached process using MCP.

An MCP server for offloading AI coding tasks to Aider, enhancing development efficiency and flexibility.

Assists AI developers with requirement clarification, module design, and technical architecture.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.