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.
| Resource | Where |
|---|---|
| Specification (source of truth) | specification/stable/skills.mdx — the extension spec, written against base protocol revision 2026-07-28 |
| Official documentation | modelcontextprotocol.io/extensions/skills/overview — condensed overview with examples and message flow |
| SEP-2640: Skills Extension | modelcontextprotocol.io/seps/2640-skills-extension — the accepted SEP (Status: Final; PR #2640 merged 2026-09-13) |
| Client support | Extension client matrix — which clients implement the extension |
The stable specification is a released snapshot and is not edited in place. 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 indocs/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.
| 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 |
| 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.
See CONTRIBUTING.md for how to participate.