modelcontextprotocol/ext-skills
Watch
1
0
Fork
You've already forked ext-skills
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
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.
95 commits 1 branch 0 tags 492 KiB
  • MDX 96.1%
  • TypeScript 3.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Sambhav Kothari 34315ab7d7
 docs: align Skills corrections with the final SEP and website (#147) 
The stable Skills page missed the final SEP's Agent Skills compatibility
clause, and its examples used abbreviated hashes and inconsistent byte
sizes. Archived drafts also retained current-sounding source-of-truth
guidance.

This corrects the stable page directly to match already-established
requirements: restores the compatibility clause, shows the resources
capability and server/discover, explains omitted request metadata, and
makes the example manifests and content consistent. It also labels
archived documents as historical and fixes the SEP domain in AGENTS.md.
This is an editorial alignment, not a new extension proposal; #142
remains separate.

Validation: all JSON examples parsed; all 13 manifest entries checked
against sample bytes for SHA-256 and size; the corrected specification
builds with the VitePress publishing site; git diff --check passed.

AI assistance: prepared with Codex.
2026-09-16 06:03:49 -07:00
.github docs: transition from Interest Group to Working Group (#81) 2026-04-17 14:27:27 -07:00
docs docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
specification/stable docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
.gitignore Add .gitignore to exclude local settings file 2026-02-03 20:07:14 -07: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 Clean and and re-organize repo docs (#146) 2026-09-16 06:56:20 +02:00
LICENSE Add Creative Commons license for project documentation 2026-02-04 07:33:09 -07: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

README.md

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.