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

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 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.