Skills MCP
Skills MCP is an AI-native skills library served via the Model Context Protocol (MCP). It provides a canonical, versioned collection of development skills that LLM agents can discover, fetch, and execute.
Quick start
Prerequisites
- Node.js 24+
- pnpm 10+
- Go 1.26+ (for the API server)
- PostgreSQL 16+ (for the database)
Running locally
# Install dependencies
pnpm install
# Start the API server
cd skills-mcp && go run ./cmd/skills-mcp serve
# Start the web frontend
pnpm dev:web
# Start the docs (this site)
pnpm dev:docs
Architecture overview
| Component | Technology | Port |
|---|---|---|
| API server | Go + Ent ORM | 8891 |
| Web frontend | Vike + React 19 + Tailwind v4 | 5173 |
| Documentation | Docusaurus | 3030 |
| Database | PostgreSQL | 5432 |
What are skills?
A skill is a versioned bundle of knowledge that tells an LLM agent how to perform a specific development task. Each skill contains:
- overview.md -- What the skill does and when to use it
- workflow.md -- Step-by-step execution instructions
- validation.md -- How to verify the work was done correctly
- scripts/ -- Optional helper scripts (bash, Python, TypeScript, etc.)
- metadata.yaml -- Tags, dependencies, and configuration
Skills are namespaced (haakco-testing, tl-web-deploy, cb-laravel-auth) and can declare dependencies on other skills via requiredSkills.
Next steps
- API Reference -- REST API endpoints
- Skills Concept -- Deep dive into skills structure and lifecycle