How do I use agent-skills-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@agent-skills-mcp list available skills" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

PyPI - Version Codecov

WARNING

This Python implementation is deprecated. Please use the Rust implementation instead: https://github.com/DiscreteTom/agent-skills-mcp-rs

Usage

Full CLI Usage

 Usage: agent-skills-mcp [OPTIONS]

 Agent Skills MCP - Load Agent Skills for your agents

╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --skill-folder  TEXT                  Path to folder containing skill markdown files [env var: SKILL_FOLDER] [default: skills] │
│ --mode          [tool|system_prompt]  Operating mode [env var: MODE] [default: tool]                                           │
│ --version                             Show version and exit                                                                    │
│ --help                                Show this message and exit.                                                              │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

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:

Install MCP Server Add to Kiro

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

Modes

system_prompt: Include skill information in MCP instructions (recommended if your agent regards MCP server instructions)
tool: Register skills as MCP tools (fallback mode since many agents ignore MCP server instructions)