docs: add Skills extension overview and support tracking by sambhav · Pull Request #3353 · modelcontextprotocol/modelcontextprotocol · GitHub
Skip to content

docs: add Skills extension overview and support tracking - #3353

Merged
localden merged 10 commits into
modelcontextprotocol:mainfrom
sambhav:docs/skills-extension-support
Sep 13, 2026
Merged

localden merged 10 commits into
modelcontextprotocol:mainfrom
sambhav:docs/skills-extension-support

Conversation

@sambhav

@sambhav sambhav commented Sep 8, 2026

Copy link
Copy Markdown
Member

Summary

Add Skills over MCP to the Extensions website:

  • An implementation overview with a brief motivation, discovery/loading flow, capability negotiation, and consistent JSON examples.
  • Guidance for direct URI lookup, lazy reads, manifest verification, updates, optional directory browsing, and client/server requirements.
  • A landing-page entry, navigation item, and Skills column with direct partial-support documentation links.

The overview follows the Tasks extension page and the Tools/Resources/Prompts conventions, with neutral client/server language, specification requirement terms, and labelled request/response examples.

Merge gate

Keep this PR in draft until SEP-2640 is Final: conformance tests and a reference implementation in any Tier 1 SDK must be merged. Tracking: conformance #330, Go #1238, and C# #1856. Recheck support before publishing.

Validation

  • npm run prep
  • git diff --check
  • Checked all 16 added live link targets and their fragments; verified the new Skills-page routes locally.
  • Compiled the MDX with GitHub-flavored Markdown; verified tables, request/response labels, and code blocks.
  • Parsed all eight JSON examples; verified both example files' byte sizes and SHA-256 digests, frontmatter, and cross-example URIs.

Local validation uses node --import tsx; repository scripts are unchanged.

AI assistance

Codex assisted with research, documentation, review fixes, the PR description, and validation at Sambhav's request.

Comment thread docs/extensions/client-matrix.mdx Outdated
Comment thread docs/extensions/client-matrix.mdx Outdated
Comment thread docs/extensions/skills/overview.mdx
@sambhav
sambhav requested a review from pja-ant September 11, 2026 07:54
@sambhav
sambhav marked this pull request as ready for review September 11, 2026 08:07
@sambhav
sambhav requested review from a team as code owners September 11, 2026 08:07
@localden
localden merged commit 2997f33 into modelcontextprotocol:main Sep 13, 2026
4 checks passed
@sambhav
sambhav deleted the docs/skills-extension-support branch September 14, 2026 12:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants