agent-skill-loader — Claude Code MCP server: how to install
Exposes static Claude Code skills to various MCP clients without duplicating local files. It turns Markdown guides into slash prompts and runtime tools.
claude mcp add agent-skill-loader -- npx -y agent-skill-loaderWhat agent-skill-loader does
The server watches designated directories for SKILL.md documents. Once indexed, these definitions become accessible as slash prompts or callable tools across compatible editors. A built-in watcher fires a listChanged event whenever folders change, keeping prompt menus fresh without restarting the client.
Five tools handle the discovery and management lifecycle. Agents can filter available guides via list_skills, inspect full text using read_skill, or copy instructions straight into .agent/skills via install_skill. Extra search directories can be appended at runtime or saved permanently in skill-paths.json.
Running the package requires Node.js version 18 or newer. If you plan to execute prompts inside automated CI environments, pass MCP_NO_WATCH=1 to disable filesystem watching.
What it helps with
- share Claude Code skills across diverse MCP editors without file duplication
- locate domain instructions dynamically through
list_skills - persist relevant skills directly into project directories using
install_skill - inspect path health and parsing issues with
debug_info
Example prompts for the agent
- Check available instructions by running
list_skillswith a search filter - Fetch the full markdown content of the testing guide with
read_skill - Install the selected skill into the local workspace using
install_skill
How to install agent-skill-loader
Platform CLI
claude mcp add agent-skill-loader -- npx -y agent-skill-loaderPlatform CLI
codex mcp add agent-skill-loader -- npx -y agent-skill-loaderConfig file
{
"mcpServers": {
"agent-skill-loader": {
"command": "npx",
"args": [
"-y",
"agent-skill-loader"
]
}
}
}Config file
{
"servers": {
"agent-skill-loader": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-skill-loader"
]
}
}
}Platform CLI
gemini mcp add agent-skill-loader npx -y agent-skill-loaderStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about agent-skill-loader
How to install agent-skill-loader in Claude Code?
Run claude mcp add agent-skill-loader -- npx -y agent-skill-loader. This fetches the package and configures the connection automatically.
What does agent-skill-loader do?
It connects markdown-based skills from your local environment to any MCP client as prompts and tools.
Can the directory watcher be disabled for CI runs?
Yes, set the MCP_NO_WATCH=1 environment variable to prevent file watching during automated tasks.
