from projects
agent-skills-mcp
Open-source template that publishes markdown skills over a single MCP server. Claude, Cursor, your own agent — they all read from the same source.
agent-skills-mcp is an open-source template that lets you publish markdown skills (Anthropic's SKILL.md format) over a single MCP server. Write a skill once — Claude, Cursor, your own agent, anything that speaks MCP reads from the same source.
- Three MCP tools: list_skills, get_skill, read_skill_file
- Anthropic SKILL.md format (progressive disclosure)
- REST view at /skills for inspection
- Streamable HTTP transport
- MIT licensed, Node ≥ 18
How it works
Skills are markdown files under the server's skills/ folder. Each skill is a directory containing SKILL.md (YAML frontmatter + body) plus optional reference/ and examples/ files. The server scans this structure on startup and exposes it to agents via three tools: catalog first, then SKILL.md, then supporting files on demand. No code, no plugins, just markdown.
Setup
Fork the repo, drop your markdown skills under skills/, deploy. About 5 minutes from clone to live URL. Runs anywhere Node runs — Railway, Render, Fly, Coolify, or your own VPS.
One thing to watch
The server is a long-running Node process. Serverless platforms like Vercel or Netlify can hit timeout issues with Streamable HTTP. Prefer platforms that support long-running Node (Railway, Render, Fly, Coolify).
Ideal use cases
- Sharing the same coding standards and commit conventions across multiple projects
- Giving every developer in your company the same skill set for their agent
- Centralizing skills so updates land everywhere automatically — no per-project copies
- Letting Claude, Cursor, and your own agents read from a shared knowledge source
Open source and template-based — you spin up your own instance on your own domain. Skills stay yours, nothing leaves your server. See the demo landing for a live example.