<div align="center">

skills2mcp

Turn any folder of Markdown agent skills into a local MCP server for Claude, Cursor, and other MCP clients.

<img src="demo.gif" alt="Demo" width="700" />

</div>

---

🎯 Why?

GitHub trending is full of agent skills, prompt packs, and MCP SDKs, but there is no zero-config bridge that makes a plain folder of Markdown skills instantly consumable by MCP clients. Developers currently copy/paste skills into prompts or write bespoke servers. skills2mcp fills that gap by scanning Markdown files and exposing them as MCP tools, prompts, and resources.

Target audience: AI developers and coding-agent power users who maintain skill libraries, prompt packs, or runbooks and want them usable by MCP-compatible assistants without building a custom server.

✨ Features

• ✨ Scan a directory for Markdown skills with optional frontmatter metadata
• ✨ Expose skills as MCP tools, prompts, and resources over stdio
• ✨ CLI commands for list, search, validate, and selftest

🚀 Quick Start

# Install
pip install skills2mcp

# Run
skills2mcp --help

📦 Installation

From Source

git clone https://github.com/YOUR_USERNAME/skills2mcp.git
cd skills2mcp

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest -v

🎬 Demo

The GIF above was recorded using Charm VHS:

vhs < demo.tape

📖 Usage

# Show help
skills2mcp --help

# Common usage examples
skills2mcp --example

🏗️ Architecture

graph LR
    A[Input] --> B[Core Engine]
    B --> C[Output]
    B --> D[Plugins]
    D --> E[Extensions]

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repo
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

MIT © 2026 — See LICENSE for details.

---

<div align="center">

If this project helped you, please ⭐ star it!

Made with ❤️ and AI

</div>