You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -102,10 +102,10 @@ This IG may propose becoming a Working Group if:
102
102
| Experimental findings repo | Proposed | Ola | Dedicated repo for implementations and evaluation results |
103
103
| SEP-2076 review | In Progress | Yu Yi | Skills as first-class primitive proposal |
104
104
| 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)|
106
106
107
107
## Success Criteria
108
108
109
109
-**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
111
111
-**Long-term:** Interoperable skill distribution across MCP servers and clients
Copy file name to clipboardExpand all lines: docs/approaches.md
+5-1Lines changed: 5 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,6 +17,8 @@ Several design considerations are emerging from community discussion:
17
17
18
18
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.
19
19
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
+
20
22
## 1. Skills as Distinct MCP Primitives
21
23
22
24
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
131
133
132
134
## 6. Official Convention as Intermediate Step
133
135
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
+
134
138
A documented "MCP Skills Convention" as a middle path between ad-hoc experiments and protocol extension. This could:
135
139
136
140
- 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
139
143
- Be documented in MCP docs as a "Pattern" — not in protocol schema, but officially recommended
140
144
- Allow data gathering on adoption before considering protocol-level changes
141
145
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.
**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).
7
7
8
8
---
9
9
10
10
## Summary
11
11
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.
0 commit comments