ext-skills/docs/archive
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
..
agent-plugins-analysis.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
approaches.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
experimental-findings.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
findings-template.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
glossary.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
open-questions.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
problem-statement.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
README.md Clean and and re-organize repo docs (#146) 2026-09-16 06:56:20 +02:00
related-work.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
sep-draft-skills-extension.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
skill-meta-keys.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
skill-uri-scheme.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
threat-model.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
use-cases.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00
why-and-when.md docs: align Skills corrections with the final SEP and website (#147) 2026-09-16 06:03:49 -07:00

Archive

Documents the Working Group produced while designing the Skills extension, frozen once SEP-2640 was marked Final (2026-09-13). They are kept for history and so the decision log can link to the material it cites. Nothing here is normative; the specification is specification/stable/skills.mdx.

Document What it was Superseded by
SEP-2640 baseline copy Verbatim copy of the SEP text pinned at an August 2026 draft commit, kept so discussion could quote stable text The published SEP-2640 and the stable specification
Why Skills Over MCP? Value proposition and decision guide written while the approach was being argued for SEP-2640 Motivation; the README
Use Cases Use cases that drove the design SEP-2640 Motivation
Approaches Map of the six approaches considered before converging on the convention approach Decision log entries 2026-02-21 and 2026-02-26; SEP-2640
Skill URI Scheme Proposal Survey of skill:// URI patterns across early implementations and the proposed convention Decision log 2026-04-16 (superseded in part by the 2026-07-16 v1 scope entry); the specification's URI rules
Open Questions Early open questions with community input, gathered before the SEP existed Decision log entries and the specification; remaining post-v1 items are tracked in issues (#131, #126)
Using _meta for Skill Resources Draft guidelines for _meta keys on skill resources Decision log 2026-03-16; the specification reserves the io.modelcontextprotocol.skills/ prefix and defines no keys
Glossary Working definitions used across the design documents The terms as defined in the specification and the Agent Skills specification
Agent Plugins x Skills Over MCP Analysis of how the Agent Plugins packaging format relates to the extension Point-in-time analysis; no successor document
Problem Statement The gaps the extension set out to address SEP-2640 Motivation
Related Work SEPs, implementations, and external resources gathered during design The extension client matrix for client support; implementation links otherwise unmaintained
Experimental Findings Results from prototype implementations, mostly against pre-v1 drafts (template) The conformance suite; new findings are shared as GitHub issues
Threat Model Threat model for skills served over MCP, written against the draft SEP, with the archive-delivery appendix The specification's Security Considerations, which made the host obligations normative