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/beta/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 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 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 |
| 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.
See CONTRIBUTING.md for how to participate.