Metadata-Version: 2.4
Name: agent-skills-mcp
Version: 0.2.0
Summary: Load Agent Skills for your agents
Project-URL: Homepage, https://github.com/DiscreteTom/agent-skills-mcp
Project-URL: Repository, https://github.com/DiscreteTom/agent-skills-mcp
Project-URL: Issues, https://github.com/DiscreteTom/agent-skills-mcp/issues
Author-email: DiscreteTom <discrete_tom@outlook.com>
License: MIT
License-File: LICENSE
Keywords: agent-skills,mcp,model-context-protocol,tools
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: fastmcp>=2.12.4
Requires-Dist: python-frontmatter>=1.1.0
Requires-Dist: typer>=0.20.0
Description-Content-Type: text/markdown

# agent-skills-mcp - Load [Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) for your agents

[![PyPI - Version](https://img.shields.io/pypi/v/agent-skills-mcp)](https://pypi.org/project/agent-skills-mcp/)
![Codecov](https://img.shields.io/codecov/c/github/DiscreteTom/agent-skills-mcp)

## Usage

### Full CLI Usage

<details>

<summary><code>uvx agent-skills-mcp --help</code></summary>

```sh
 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.                                                              │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
```

</details>

### Setup

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

```sh
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](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=skills&config=eyJlbnYiOnsiU0tJTExfRk9MREVSIjoifi9za2lsbHMifSwiY29tbWFuZCI6InV2eCBhZ2VudC1za2lsbHMtbWNwIn0%3D)
[![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](kiro://kiro.mcp/add?name=skills&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22agent-skills-mcp%22%5D%2C%22env%22%3A%7B%22SKILL_FOLDER%22%3A%22~%2Fskills%22%7D%7D)

```json
{
  "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)

## [CHANGELOG](./CHANGELOG.md)
