Skills Over MCP Working Group
This repository is the home of the official Model Context Protocol Skills extension (io.modelcontextprotocol/skills), based on SEP-2640, and of the Skills Over MCP Working Group's working documents.
Specification
The specification is a released revision and is not edited in place. The extension is at the Beta stage of the extension lifecycle. Changes are proposed as dated entries in the decision log (see AGENTS.md for the process) and, once accepted, land in a draft revision of the specification that ships as a new release.
ℹ️ The docs/ folder holds the decision log, the design rationale, and the implementations list. Earlier design documents, findings, and trackers are frozen in docs/archive/. None of it is part of the specification.
Charter: modelcontextprotocol.io/community/working-groups/skills-over-mcp — mission, scope, membership, active work items, and success criteria.
Project board: Skills Over MCP WG
Meeting notes: Skills Over MCP WG discussions
Discord: #skills-over-mcp-wg
Open work: Pull requests and issues — proposals, decisions, implementations, and other in-flight contributions welcome.
Repository Contents
| Document | Description |
|---|
| Specification | The Skills extension specification (io.modelcontextprotocol/skills) — source of truth |
| Decision Log | ADR-lite record of the group's decisions, and the vehicle for proposing changes to the specification |
| Rationale | Design rationale for the Resources-based extension |
| Implementations | Servers, SDKs, and hosts that serve or consume skills over MCP |
| Maintainers | Extension Maintainers for the Skills extension |
| Archive | Pre-release design documents, findings, and trackers, frozen when SEP-2640 was marked Final |
For the case for serving skills over MCP, see the official overview and the Motivation section of SEP-2640.
Contributing
See CONTRIBUTING.md for how to participate.
