Skip to content

Commit 6aa5ba7

Browse files
olaservoclaude
andcommitted
Update docs to reflect convention-to-SEP evolution
The "MCP Skills Convention v0.1" (issue modelcontextprotocol#43, now closed) graduated into the draft Skills Extension SEP (PR modelcontextprotocol#69). Update docs to reflect this: - README: work tracking row now shows SEP with Peter as champion, success criteria notes the SEP as current direction - approaches.md: status note under Central Tension, status banner on Approach 6 noting it graduated to the SEP - skill-uri-scheme.md: status updated from Draft to incorporated into SEP, removed outdated "MCP Skills Convention" phrasing Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 045aa21 commit 6aa5ba7

3 files changed

Lines changed: 9 additions & 5 deletions

File tree

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -102,10 +102,10 @@ This IG may propose becoming a Working Group if:
102102
| Experimental findings repo | Proposed | Ola | Dedicated repo for implementations and evaluation results |
103103
| SEP-2076 review | In Progress | Yu Yi | Skills as first-class primitive proposal |
104104
| Registry skills.json proposal | In Progress | Ozz | Skills metadata in registry schema |
105-
| MCP Skills Convention v0.1 | Proposed | TBD | Documented pattern (not spec) for skills over existing primitives |
105+
| Skills Extension SEP | In Review | Peter (@pja-ant) | Extensions Track SEP for `skill://` resource convention ([#75](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/75)); evolved from Convention v0.1 (#43) |
106106

107107
## Success Criteria
108108

109109
- **Short-term:** Documented consensus on requirements and evaluation of existing approaches
110-
- **Medium-term:** Clear recommendation (convention vs. protocol extension vs. both)
110+
- **Medium-term:** Clear recommendation (convention vs. protocol extension vs. both) — the draft [Skills Extension SEP](https://github.com/modelcontextprotocol/experimental-ext-skills/pull/69) represents the IG's current direction: a formal extension using existing Resources primitives
111111
- **Long-term:** Interoperable skill distribution across MCP servers and clients

docs/approaches.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,8 @@ Several design considerations are emerging from community discussion:
1717

1818
The approaches below span a spectrum. At one end, skills become a first-class MCP primitive with dedicated protocol methods (Approach 1). At the other, existing primitives are used with documented conventions (Approach 6). A key question for this IG is whether convention can prove patterns before standardization — or whether the ecosystem needs protocol-level support to achieve reliable interoperability. These are not mutually exclusive; convention work can inform and de-risk a future protocol extension.
1919

20+
**Current status:** The convention approach (Approach 6) was pursued and quickly evolved into a formal Extensions Track SEP ([#69](https://github.com/modelcontextprotocol/experimental-ext-skills/pull/69)), building on convergence across 4+ independent `skill://` implementations. The SEP uses existing Resources primitives with zero protocol changes, positioning it between pure convention and a new primitive. See [#75](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/75) for tracking.
21+
2022
## 1. Skills as Distinct MCP Primitives
2123

2224
Add Agent Skills as a first-class, discoverable primitive in MCP. A skill is a named bundle of instructions plus references to tools, prompts, and resources that together teach an agent how to perform a domain-specific workflow.
@@ -131,6 +133,8 @@ Use server instructions as a pointer to a resource: "If you need to do X, fetch
131133

132134
## 6. Official Convention as Intermediate Step
133135

136+
> **Status:** This approach was pursued and graduated into the draft [Skills Extension SEP](https://github.com/modelcontextprotocol/experimental-ext-skills/pull/69) ([#75](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/75)). The SEP formalizes the convention as an Extensions Track specification using existing Resources primitives — zero protocol changes, backward compatible. Content format is delegated to [agentskills.io](https://agentskills.io/specification). The text below is preserved as historical context for how this approach was originally framed.
137+
134138
A documented "MCP Skills Convention" as a middle path between ad-hoc experiments and protocol extension. This could:
135139

136140
- Define well-known URI schemes or naming patterns (e.g., resources matching `**/SKILL.md`). See [Skill URI Scheme Proposal](skill-uri-scheme.md) for a detailed survey and recommendation.
@@ -139,7 +143,7 @@ A documented "MCP Skills Convention" as a middle path between ad-hoc experiments
139143
- Be documented in MCP docs as a "Pattern" — not in protocol schema, but officially recommended
140144
- Allow data gathering on adoption before considering protocol-level changes
141145

142-
This mirrors how other ecosystems (e.g., Kubernetes) graduate patterns: start as convention, prove value, then formalize. Could be a concrete IG deliverable: "MCP Skills Convention v0.1."
146+
This mirrors how other ecosystems (e.g., Kubernetes) graduate patterns: start as convention, prove value, then formalize.
143147

144148
**Advantages of the convention approach:**
145149

docs/skill-uri-scheme.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,13 @@
33
> Proposed convention for identifying skill resources over MCP.
44
55
**Issue:** [#44](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/44)
6-
**Status:** Draft
6+
**Status:** Incorporated into the draft [Skills Extension SEP](https://github.com/modelcontextprotocol/experimental-ext-skills/pull/69). This survey informed the SEP's URI scheme design; see also [PR #70](https://github.com/modelcontextprotocol/experimental-ext-skills/pull/70) for subsequent refinements (multi-segment paths, path-name decoupling).
77

88
---
99

1010
## Summary
1111

12-
This document surveys existing URI patterns for skill resources across implementations, analyzes their trade-offs, and proposes a recommended `skill://` URI scheme for the MCP Skills Convention.
12+
This document surveys existing URI patterns for skill resources across implementations, analyzes their trade-offs, and proposes a recommended `skill://` URI scheme for skill resources over MCP.
1313

1414
## Survey of Existing Patterns
1515

0 commit comments

Comments
 (0)