agent-skills-mcp - Load Agent Skills for your agents

Usage

Full CLI Usage

agent-skills-mcp --help

Agent Skills MCP - Load Agent Skills for your agents

Usage: agent-skills-mcp [OPTIONS]

Options:
      --skill-folder <SKILL_FOLDER>  Path(s) to folder(s) containing skill markdown files (repeat or comma-separate) [env: SKILL_FOLDER=] [default: skills]
      --mode <MODE>                  Operating mode [env: MODE=] [default: single_tool]
  -h, --help                         Print help
  -V, --version                      Print version

Setup

First, put your skills in ~/skills, e.g.

git clone https://github.com/anthropics/skills.git ~/skills

The server recursively searches for SKILL.md files and follows symlinks, allowing flexible skill organization.

Then, add this to your MCP client configuration:

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "agent-skills-mcp"],
      "env": {
        "SKILL_FOLDER": "~/skills"
      }
    }
  }
}

Multiple Skill Folders

You can load skills from multiple folders by repeating the --skill-folder flag or using a comma-separated list in the SKILL_FOLDER env var. A common pattern is to keep global skills in ~/skills and workspace-specific skills in ./skills:

{
  "mcpServers": {
    "skills": {
      "command": "npx",
      "args": ["-y", "agent-skills-mcp"],
      "env": {
        "SKILL_FOLDER": "~/skills,./skills"
      }
    }
  }
}

Modes

• single_tool (default): Register a single get_skill tool that accepts a skill name parameter, with all skills listed in the tool description. This reduces the number of tools exposed to the agent.
• tool: Register each skill as a separate MCP tool (e.g., get_skill_name1, get_skill_name2)
• system_prompt: Include skill information in MCP instructions

Install Standalone Binary

Shell (macOS/Linux)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/DiscreteTom/agent-skills-mcp-rs/releases/latest/download/agent-skills-mcp-installer.sh | sh

PowerShell (Windows)

irm https://github.com/DiscreteTom/agent-skills-mcp-rs/releases/latest/download/agent-skills-mcp-installer.ps1 | iex

npm

npm install -g agent-skills-mcp

CHANGELOG