Skip to content

SEP-2640: Skills Extension - #2640

Merged
localden merged 54 commits into
mainfrom
sep/skills-extension
Sep 13, 2026
Merged

localden merged 54 commits into
mainfrom
sep/skills-extension

Conversation

@pja-ant

@pja-ant pja-ant commented Apr 23, 2026

Copy link
Copy Markdown
Contributor

Extensions Track SEP defining the skill:// resource convention for serving Agent Skills over MCP. Developed by the Skills Over MCP Working Group; transports the design from experimental-ext-skills#69 with archive distribution per experimental-ext-skills#83.

Extension identifier: io.modelcontextprotocol/skills.

Reference implementations: TypeScript SDK wrappers, Python/C#/Go SDKs (modelcontextprotocol/python-sdk#3485, modelcontextprotocol/csharp-sdk#1856, modelcontextprotocol/go-sdk#1238), host prototypes in gemini-cli/fast-agent/goose/codex/Claude Code, and the GitHub MCP Server. Conformance tests: modelcontextprotocol/conformance#330.

@pja-ant
pja-ant requested a review from olaservo April 23, 2026 19:46
@pja-ant
pja-ant force-pushed the sep/skills-extension branch from 1f35055 to 7b35855 Compare April 23, 2026 19:47
@pja-ant pja-ant changed the title SEP: Skills Extension SEP-2640: Skills Extension Apr 23, 2026
@pja-ant pja-ant added SEP draft SEP proposal with a sponsor. extension labels Apr 23, 2026
@pja-ant
pja-ant marked this pull request as ready for review April 23, 2026 19:51
@pja-ant
pja-ant requested review from a team as code owners April 23, 2026 19:51
@pja-ant pja-ant self-assigned this Apr 23, 2026
@olaservo olaservo moved this from Backlog to In review in Skills Over MCP Working Group Apr 24, 2026
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md Outdated
Comment thread seps/2640-skills-extension.md
Comment thread docs/seps/2640-skills-extension.mdx Outdated
Comment thread seps/2640-skills-extension.md Outdated
olaservo added a commit to olaservo/skilljack-mcp that referenced this pull request May 3, 2026
* Align resource layer with SEP-2640 (Skills Extension)

Replace legacy `skill://{name}` and `skill://{name}/` URIs with the SEP-2640
shape: `skill://<skill-path>/SKILL.md` for skill markdown, individual files
addressable as siblings, and a new `skill://index.json` discovery resource.
Declares the `io.modelcontextprotocol/skills` extension in initialize
capabilities, and adds `getSkillPath` / `buildSkillResourceUri` /
`parseSkillResourceUri` / `buildSkillIndex` helpers in skill-discovery.ts.

This is a breaking change to the URI scheme; pre-1.0, draft SEP, no shims.

SEP: modelcontextprotocol/modelcontextprotocol#2640

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>

* Update CLAUDE.md for SEP-2640 resource layer

Document the new URI shapes, the `extensions["io.modelcontextprotocol/skills"]`
capability, and the four SEP helpers in skill-discovery.ts. Note the explicit
`skill://index.json` update notification fired from `refreshSkills()`.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <[email protected]>
pja-ant and others added 3 commits September 11, 2026 17:10
The reference implementations and conformance tests are in place.
Update the status, list the Python, C#, and Go SDK implementations and
the conformance scenarios, and regenerate the rendered SEP docs, index,
and navigation.

Co-Authored-By: Claude <[email protected]>
Claude-Session: https://claude.ai/code/session_019d7QxKee8JfJ5jQrUj1hxM
render-seps on main now prepends a historical-record note to every
Final SEP page, and the PR check renders against the merge with main.

Co-Authored-By: Claude <[email protected]>
Claude-Session: https://claude.ai/code/session_019d7QxKee8JfJ5jQrUj1hxM
sambhav
sambhav previously approved these changes Sep 11, 2026
@localden

Copy link
Copy Markdown
Contributor

This was accepted by Core Maintainer vote.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: No status
Status: Done

Development

Successfully merging this pull request may close these issues.