Mirror of https://github.com/modelcontextprotocol/ext-skills — MCP Extension for Skills discovery and distribution through MCP primitives. Maintained by the Skills Over MCP Working Group.
  • MDX 96.1%
  • TypeScript 3.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Sambhav Kothari 0e85d4db88
Some checks failed
CI / Build documentation (push) Has been cancelled
Update CODEOWNERS to reflect new team assignment (#148)
This pull request makes a small update to the `.github/CODEOWNERS` file,
changing the default code owners group to reflect the correct team
assignment.
2026-09-18 11:05:19 +02:00
.github Update CODEOWNERS to reflect new team assignment (#148) 2026-09-18 11:05:19 +02:00
.vitepress Publish Skills documentation with VitePress and Cloudflare Pages (#143) 2026-09-16 17:06:02 +02:00
docs docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
public Publish Skills documentation with VitePress and Cloudflare Pages (#143) 2026-09-16 17:06:02 +02:00
specification/stable Publish Skills documentation with VitePress and Cloudflare Pages (#143) 2026-09-16 17:06:02 +02:00
.gitignore Publish Skills documentation with VitePress and Cloudflare Pages (#143) 2026-09-16 17:06:02 +02:00
AGENTS.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
CLAUDE.md docs: sync SEP copy with v1 and add AGENTS.md (#117) 2026-08-02 20:56:31 -07:00
CONTRIBUTING.md Publish Skills documentation with VitePress and Cloudflare Pages (#143) 2026-09-16 17:06:02 +02:00
index.md Publish Skills documentation with VitePress and Cloudflare Pages (#143) 2026-09-16 17:06:02 +02:00
LICENSE Add Creative Commons license for project documentation 2026-02-04 07:33:09 -07:00
package-lock.json Publish Skills documentation with VitePress and Cloudflare Pages (#143) 2026-09-16 17:06:02 +02:00
package.json Publish Skills documentation with VitePress and Cloudflare Pages (#143) 2026-09-16 17:06:02 +02:00
README.md Clean and and re-organize repo docs (#146) 2026-09-16 06:56:20 +02:00
SECURITY.md Add SECURITY.md (#137) 2026-09-16 06:58:51 +02:00

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