Skip to main content
Glama

skills2mcp

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

License Language Status PyPI version License: MIT MCP


🎯 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.

Related MCP server: Skillz

✨ 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.


If this project helped you, please ⭐ star it!

Made with ❀️ and AI

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Converts AI Skills (following Claude Skills format) into MCP server resources, enabling LLM applications to discover, access, and utilize self-contained skill directories through the Model Context Protocol. Provides tools to list available skills, retrieve skill details and content, and read supporting files with security protections.
      3
      39 PyPI
      30
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Turns Claude-style skills (SKILL.md files with resources) into callable MCP tools for any agent. Discovers skills from a directory, exposes their instructions and resources, and can execute bundled helper scripts.
      118 PyPI
      410
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server that transforms Claude-style skills and resources into callable tools for any MCP-compatible agent or client. It automatically discovers, exposes, and executes scripts from skills organized in local directories or packaged archives.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A universal MCP server that loads Markdown skills from arbitrary folders, enabling lazy discovery and execution of skills across multiple MCP-capable tools.
      5
      56 npm
      2
      MIT