# skills-mcp

MCP server that serves **agent skills** (`SKILL.md` bundles, the format used by
Claude Code plugin skill repos like [cloudflare/skills](https://github.com/cloudflare/skills))
to any MCP client — including clients that can't install plugins, such as
claude.ai / Claude Desktop connectors or an aggregator like MetaMCP.

Skills are exposed two ways:

- **Tools** — `list_skills`, `read_skill`, `read_skill_file` for tool-oriented
  clients. The server's MCP `instructions` list every skill so models know
  when to load one.
- **Resources** — `skill://<name>/SKILL.md` (plus each bundled file) for
  resource-aware clients.

## Configuration

| Env var | Meaning |
|---|---|
| `SKILLS_SOURCES` | Comma-separated skill sources (required). Each entry is `owner/repo`, `owner/repo#ref`, or an absolute local path. |
| `SKILLS_CACHE_DIR` | Cache directory for GitHub tarballs (default: OS tmpdir). |

GitHub sources are fetched as tarballs on startup (no `git` needed) and fall
back to the cached copy if the fetch fails.

## Usage

```bash
SKILLS_SOURCES=cloudflare/skills,raymatos/my-skills npx -y skills-mcp-server
```

Any directory containing a `SKILL.md` (searched up to 6 levels deep) is a
skill; YAML frontmatter `name:` and `description:` are used when present.

## License

MIT