skills2mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
skills2mcp
Turn any folder of Markdown agent skills into a local MCP server for Claude, Cursor, and other MCP clients.
π― 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:
Fork the repo
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
π License
MIT Β© 2026 β See LICENSE for details.
If this project helped you, please β star it!
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
Related MCP Connectors
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
Nifty's MCP server β exposes tasks, projects, messages, and files as tools for AI agents.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Related MCP Servers
- AlicenseAqualityDmaintenanceConverts 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.339 PyPI30Apache 2.0
- AlicenseNot gradedqualityDmaintenanceTurns 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 PyPI410MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn 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
- AlicenseBqualityDmaintenanceA universal MCP server that loads Markdown skills from arbitrary folders, enabling lazy discovery and execution of skills across multiple MCP-capable tools.556 npm2MIT