From 258f82e4c8132fb44f173623ff3c694ae222c01a Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 19:51:25 -0700 Subject: [PATCH 1/9] Update documentation for Skills Extension SEP and related resources - Revised links and descriptions in README.md to reflect the submitted Skills Extension SEP (PR #2640). - Updated current status in approaches.md to indicate submission of the Skills Extension SEP. - Clarified tracking information in open-questions.md regarding the Skills Extension SEP submission. - Adjusted related work in related-work.md to include the Skills Extension SEP and mark a rejected proposal. - Changed status in sep-draft-skills-extension.md to 'submitted' and updated author information. - Enhanced skill-uri-scheme.md to indicate the incorporation of feedback into the submitted Skills Extension SEP. --- README.md | 2 +- docs/approaches.md | 2 +- docs/open-questions.md | 2 +- docs/related-work.md | 3 ++- docs/sep-draft-skills-extension.md | 8 ++++---- docs/skill-uri-scheme.md | 2 +- 6 files changed, 10 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index cd48275..b009aa5 100644 --- a/README.md +++ b/README.md @@ -38,7 +38,7 @@ See [problem-statement.md](docs/problem-statement.md) for full details. | [Experimental Findings](docs/experimental-findings.md) | Results from implementations and testing | | [Related Work](docs/related-work.md) | SEPs, implementations, and external resources | | [Decision Log](docs/decisions.md) | Record of key decisions with context and rationale | -| [Draft SEP: Skills Extension](docs/sep-draft-skills-extension.md) | Pre-submission SEP draft defining the `skill://` resource convention | +| [Skills Extension SEP — PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | Proposal to serve skills over MCP via the Resources primitive and `skill://` URI scheme. Original working draft: [`docs/sep-draft-skills-extension.md`](docs/sep-draft-skills-extension.md). Comments and review happen on the PR. | ## Contributing diff --git a/docs/approaches.md b/docs/approaches.md index b00d516..4d24480 100644 --- a/docs/approaches.md +++ b/docs/approaches.md @@ -17,7 +17,7 @@ Several design considerations are emerging from community discussion: 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 WG 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. -**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. +**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. Submitted to the MCP spec as [PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) on 2026-04-23. ## 1. Skills as Distinct MCP Primitives diff --git a/docs/open-questions.md b/docs/open-questions.md index 3339e7b..1871755 100644 --- a/docs/open-questions.md +++ b/docs/open-questions.md @@ -121,7 +121,7 @@ See also [Approaches](approaches.md) for more notes on using resources. ## 13. What is the optimal relationship between skills and MCP? -> **Tracked in:** [#75](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/75) — Skills Extension SEP +> **Tracked in:** [#75](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/75) — Skills Extension SEP (submitted as [PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640)) > **See also:** [#47](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/47) — Create evaluation matrix mapping approaches to requirements Skills already work as simple files that agents load directly. Adding MCP to the process should provide clear value beyond what standalone skills already offer. diff --git a/docs/related-work.md b/docs/related-work.md index b186ca7..354f7eb 100644 --- a/docs/related-work.md +++ b/docs/related-work.md @@ -5,8 +5,9 @@ | Proposal | Venue | Description | | :--- | :--- | :--- | | [SEP-2076](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2076) | MCP Spec | Agent Skills as a first-class MCP primitive | -| [SEP-2093](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093) | MCP Spec | Resource Contents Metadata and Capabilities: scoped `resources/list`, per-resource capabilities, `resources/metadata` endpoint | +| ~~[SEP-2093](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)~~ | MCP Spec | ~~Resource Contents Metadata and Capabilities: scoped `resources/list`, per-resource capabilities, `resources/metadata` endpoint~~ — **rejected** ([labeled upstream](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)) | | [PR #2527](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2527) | MCP Spec | Recommend clients expose resource read to models — prerequisite for the resources-based skills approach | +| [PR #2640 (Skills Extension SEP)](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | MCP Spec | This WG's proposed extension: skills served over MCP using the Resources primitive and `skill://` URI scheme ([working draft](sep-draft-skills-extension.md)) | | [skills.json format proposal](https://github.com/modelcontextprotocol/registry/discussions/895) | MCP Registry | Skills metadata in registry schema | ## Working Group Member Implementations diff --git a/docs/sep-draft-skills-extension.md b/docs/sep-draft-skills-extension.md index 799c604..b95f8b9 100644 --- a/docs/sep-draft-skills-extension.md +++ b/docs/sep-draft-skills-extension.md @@ -1,14 +1,14 @@ # SEP-0000: Skills Extension -- **Status**: Draft (pre-submission) +- **Status**: Draft (submitted) - **Type**: Extensions Track - **Created**: 2026-03-17 -- **Author(s)**: Skills Over MCP Interest Group +- **Author(s)**: Skills Over MCP Working Group - **Sponsor**: _(seeking)_ - **Extension Identifier**: `io.modelcontextprotocol/skills` -- **PR**: _(to be assigned on submission)_ +- **PR**: [#2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) -> This document is a pre-submission draft maintained by the [Skills Over MCP Interest Group](https://github.com/modelcontextprotocol/experimental-ext-skills). It has not yet been submitted to the main MCP repository. Discussion welcome via [GitHub Issues](https://github.com/modelcontextprotocol/experimental-ext-skills/issues) or [Discord #skills-over-mcp-ig](https://discord.com/channels/1358869848138059966/1464745826629976084). +> **NOTE:** This SEP has been submitted to the main MCP repository as [PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640); future review and comments happen there. This repo-local copy is the working draft maintained by the [Skills Over MCP Working Group](https://github.com/modelcontextprotocol/experimental-ext-skills) and may be revised as upstream review feedback is incorporated. Additional discussion welcome via [GitHub Issues](https://github.com/modelcontextprotocol/experimental-ext-skills/issues) or [Discord #skills-over-mcp-wg](https://discord.com/channels/1358869848138059966/1464745826629976084). ## Abstract diff --git a/docs/skill-uri-scheme.md b/docs/skill-uri-scheme.md index cfd5a42..1b44f7d 100644 --- a/docs/skill-uri-scheme.md +++ b/docs/skill-uri-scheme.md @@ -3,7 +3,7 @@ > Proposed convention for identifying skill resources over MCP. **Issue:** [#44](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/44) -**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). +**Status:** Incorporated into the draft [Skills Extension SEP](https://github.com/modelcontextprotocol/experimental-ext-skills/pull/69), now submitted to the MCP spec as [PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640). 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). --- From eaac3bf61969ec303d249398f086ee829a0bd5df Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 19:52:51 -0700 Subject: [PATCH 2/9] Move rejected SEP-2093 to the bottom of SEPs and Proposals table MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Keeps the list active-proposals-first so readers aren't distracted by the struck-out entry. 🦉 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/related-work.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/related-work.md b/docs/related-work.md index 354f7eb..f8f5ea6 100644 --- a/docs/related-work.md +++ b/docs/related-work.md @@ -5,10 +5,10 @@ | Proposal | Venue | Description | | :--- | :--- | :--- | | [SEP-2076](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2076) | MCP Spec | Agent Skills as a first-class MCP primitive | -| ~~[SEP-2093](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)~~ | MCP Spec | ~~Resource Contents Metadata and Capabilities: scoped `resources/list`, per-resource capabilities, `resources/metadata` endpoint~~ — **rejected** ([labeled upstream](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)) | | [PR #2527](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2527) | MCP Spec | Recommend clients expose resource read to models — prerequisite for the resources-based skills approach | | [PR #2640 (Skills Extension SEP)](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | MCP Spec | This WG's proposed extension: skills served over MCP using the Resources primitive and `skill://` URI scheme ([working draft](sep-draft-skills-extension.md)) | | [skills.json format proposal](https://github.com/modelcontextprotocol/registry/discussions/895) | MCP Registry | Skills metadata in registry schema | +| ~~[SEP-2093](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)~~ | MCP Spec | ~~Resource Contents Metadata and Capabilities: scoped `resources/list`, per-resource capabilities, `resources/metadata` endpoint~~ — **rejected** ([labeled upstream](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)) | ## Working Group Member Implementations From 166c56f6145635808dae718b35118f4cacfebd4f Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 19:55:43 -0700 Subject: [PATCH 3/9] Mark SEP-2076 as closed and move to the bottom of proposals table MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR #2076 was closed without merge on 2026-02-24. 🦉 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/related-work.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/related-work.md b/docs/related-work.md index f8f5ea6..59f22ae 100644 --- a/docs/related-work.md +++ b/docs/related-work.md @@ -4,11 +4,11 @@ | Proposal | Venue | Description | | :--- | :--- | :--- | -| [SEP-2076](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2076) | MCP Spec | Agent Skills as a first-class MCP primitive | | [PR #2527](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2527) | MCP Spec | Recommend clients expose resource read to models — prerequisite for the resources-based skills approach | | [PR #2640 (Skills Extension SEP)](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | MCP Spec | This WG's proposed extension: skills served over MCP using the Resources primitive and `skill://` URI scheme ([working draft](sep-draft-skills-extension.md)) | | [skills.json format proposal](https://github.com/modelcontextprotocol/registry/discussions/895) | MCP Registry | Skills metadata in registry schema | | ~~[SEP-2093](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)~~ | MCP Spec | ~~Resource Contents Metadata and Capabilities: scoped `resources/list`, per-resource capabilities, `resources/metadata` endpoint~~ — **rejected** ([labeled upstream](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)) | +| ~~[SEP-2076](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2076)~~ | MCP Spec | ~~Agent Skills as a first-class MCP primitive~~ — **closed** (2026-02-24, without merge) | ## Working Group Member Implementations From 8f9b4390e9ced91d348e3ecbdc91a28d1c42e958 Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 20:05:07 -0700 Subject: [PATCH 4/9] Use SEP-2640 naming convention per MCP SEP guidelines MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per https://modelcontextprotocol.io/community/sep-guidelines, a submitted SEP is named "SEP-". Rename in-repo references from "PR #2640" to "SEP-2640" and update the draft doc heading from the "SEP-0000" placeholder to "SEP-2640". Also mark Approach 1's SEP-2076 status as closed (2026-02-24, no sponsor found); approaches.md still listed it as "Draft, seeking sponsor". 🦉 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 2 +- docs/approaches.md | 4 ++-- docs/open-questions.md | 2 +- docs/related-work.md | 2 +- docs/sep-draft-skills-extension.md | 4 ++-- docs/skill-uri-scheme.md | 2 +- 6 files changed, 8 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index b009aa5..23ee25d 100644 --- a/README.md +++ b/README.md @@ -38,7 +38,7 @@ See [problem-statement.md](docs/problem-statement.md) for full details. | [Experimental Findings](docs/experimental-findings.md) | Results from implementations and testing | | [Related Work](docs/related-work.md) | SEPs, implementations, and external resources | | [Decision Log](docs/decisions.md) | Record of key decisions with context and rationale | -| [Skills Extension SEP — PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | Proposal to serve skills over MCP via the Resources primitive and `skill://` URI scheme. Original working draft: [`docs/sep-draft-skills-extension.md`](docs/sep-draft-skills-extension.md). Comments and review happen on the PR. | +| [SEP-2640: Skills Extension](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | Proposal to serve skills over MCP via the Resources primitive and `skill://` URI scheme. Original working draft: [`docs/sep-draft-skills-extension.md`](docs/sep-draft-skills-extension.md). Comments and review happen on the PR. | ## Contributing diff --git a/docs/approaches.md b/docs/approaches.md index 4d24480..31432a2 100644 --- a/docs/approaches.md +++ b/docs/approaches.md @@ -17,7 +17,7 @@ Several design considerations are emerging from community discussion: 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 WG 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. -**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. Submitted to the MCP spec as [PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) on 2026-04-23. +**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. Submitted to the MCP spec as [SEP-2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) on 2026-04-23. ## 1. Skills as Distinct MCP Primitives @@ -35,7 +35,7 @@ Add Agent Skills as a first-class, discoverable primitive in MCP. A skill is a n - Progressive disclosure: clients load skill summaries at startup, fetch full instructions on demand - Mapping to existing SKILL.md format -**Status:** Draft, seeking sponsor. +**Status:** Closed without merge on 2026-02-24; did not find a sponsor. See [SEP-2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) for this WG's alternative Resources-based approach. **Community input:** diff --git a/docs/open-questions.md b/docs/open-questions.md index 1871755..e4c4881 100644 --- a/docs/open-questions.md +++ b/docs/open-questions.md @@ -121,7 +121,7 @@ See also [Approaches](approaches.md) for more notes on using resources. ## 13. What is the optimal relationship between skills and MCP? -> **Tracked in:** [#75](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/75) — Skills Extension SEP (submitted as [PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640)) +> **Tracked in:** [#75](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/75) — Skills Extension SEP (submitted as [SEP-2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640)) > **See also:** [#47](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/47) — Create evaluation matrix mapping approaches to requirements Skills already work as simple files that agents load directly. Adding MCP to the process should provide clear value beyond what standalone skills already offer. diff --git a/docs/related-work.md b/docs/related-work.md index 59f22ae..5ac8361 100644 --- a/docs/related-work.md +++ b/docs/related-work.md @@ -5,7 +5,7 @@ | Proposal | Venue | Description | | :--- | :--- | :--- | | [PR #2527](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2527) | MCP Spec | Recommend clients expose resource read to models — prerequisite for the resources-based skills approach | -| [PR #2640 (Skills Extension SEP)](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | MCP Spec | This WG's proposed extension: skills served over MCP using the Resources primitive and `skill://` URI scheme ([working draft](sep-draft-skills-extension.md)) | +| [SEP-2640 (Skills Extension)](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | MCP Spec | This WG's proposed extension: skills served over MCP using the Resources primitive and `skill://` URI scheme ([working draft](sep-draft-skills-extension.md)) | | [skills.json format proposal](https://github.com/modelcontextprotocol/registry/discussions/895) | MCP Registry | Skills metadata in registry schema | | ~~[SEP-2093](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)~~ | MCP Spec | ~~Resource Contents Metadata and Capabilities: scoped `resources/list`, per-resource capabilities, `resources/metadata` endpoint~~ — **rejected** ([labeled upstream](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)) | | ~~[SEP-2076](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2076)~~ | MCP Spec | ~~Agent Skills as a first-class MCP primitive~~ — **closed** (2026-02-24, without merge) | diff --git a/docs/sep-draft-skills-extension.md b/docs/sep-draft-skills-extension.md index b95f8b9..a3b7475 100644 --- a/docs/sep-draft-skills-extension.md +++ b/docs/sep-draft-skills-extension.md @@ -1,4 +1,4 @@ -# SEP-0000: Skills Extension +# SEP-2640: Skills Extension - **Status**: Draft (submitted) - **Type**: Extensions Track @@ -8,7 +8,7 @@ - **Extension Identifier**: `io.modelcontextprotocol/skills` - **PR**: [#2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) -> **NOTE:** This SEP has been submitted to the main MCP repository as [PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640); future review and comments happen there. This repo-local copy is the working draft maintained by the [Skills Over MCP Working Group](https://github.com/modelcontextprotocol/experimental-ext-skills) and may be revised as upstream review feedback is incorporated. Additional discussion welcome via [GitHub Issues](https://github.com/modelcontextprotocol/experimental-ext-skills/issues) or [Discord #skills-over-mcp-wg](https://discord.com/channels/1358869848138059966/1464745826629976084). +> **NOTE:** This SEP has been submitted to the main MCP repository as [SEP-2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640); future review and comments happen there. This repo-local copy is the working draft maintained by the [Skills Over MCP Working Group](https://github.com/modelcontextprotocol/experimental-ext-skills) and may be revised as upstream review feedback is incorporated. Additional discussion welcome via [GitHub Issues](https://github.com/modelcontextprotocol/experimental-ext-skills/issues) or [Discord #skills-over-mcp-wg](https://discord.com/channels/1358869848138059966/1464745826629976084). ## Abstract diff --git a/docs/skill-uri-scheme.md b/docs/skill-uri-scheme.md index 1b44f7d..5806d15 100644 --- a/docs/skill-uri-scheme.md +++ b/docs/skill-uri-scheme.md @@ -3,7 +3,7 @@ > Proposed convention for identifying skill resources over MCP. **Issue:** [#44](https://github.com/modelcontextprotocol/experimental-ext-skills/issues/44) -**Status:** Incorporated into the draft [Skills Extension SEP](https://github.com/modelcontextprotocol/experimental-ext-skills/pull/69), now submitted to the MCP spec as [PR #2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640). 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). +**Status:** Incorporated into the draft [Skills Extension SEP](https://github.com/modelcontextprotocol/experimental-ext-skills/pull/69), now submitted to the MCP spec as [SEP-2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640). 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). --- From 44893c973d9c18d00f3b46cbdbf5cffbb1053e07 Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 20:06:55 -0700 Subject: [PATCH 5/9] Fix SEP-2076 closure rationale MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closure followed the WG's decision to first explore a convention-based approach using existing primitives, not a sponsor issue. 🦉 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/approaches.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/approaches.md b/docs/approaches.md index 31432a2..c361dfb 100644 --- a/docs/approaches.md +++ b/docs/approaches.md @@ -35,7 +35,7 @@ Add Agent Skills as a first-class, discoverable primitive in MCP. A skill is a n - Progressive disclosure: clients load skill summaries at startup, fetch full instructions on demand - Mapping to existing SKILL.md format -**Status:** Closed without merge on 2026-02-24; did not find a sponsor. See [SEP-2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) for this WG's alternative Resources-based approach. +**Status:** Closed on 2026-02-24 after the WG decided to first explore a convention-based approach using existing primitives. See [SEP-2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) for the resulting Resources-based proposal. **Community input:** From c48de7df986ac5ce60e7e6c2a848793597ec5568 Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 20:11:56 -0700 Subject: [PATCH 6/9] Refine SEP-2640 description in README to clarify proposal details --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 23ee25d..bf486b4 100644 --- a/README.md +++ b/README.md @@ -38,7 +38,7 @@ See [problem-statement.md](docs/problem-statement.md) for full details. | [Experimental Findings](docs/experimental-findings.md) | Results from implementations and testing | | [Related Work](docs/related-work.md) | SEPs, implementations, and external resources | | [Decision Log](docs/decisions.md) | Record of key decisions with context and rationale | -| [SEP-2640: Skills Extension](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | Proposal to serve skills over MCP via the Resources primitive and `skill://` URI scheme. Original working draft: [`docs/sep-draft-skills-extension.md`](docs/sep-draft-skills-extension.md). Comments and review happen on the PR. | +| [SEP-2640: Skills Extension](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | Proposal to serve skills over MCP via the Resources primitive. Original working draft: [`docs/sep-draft-skills-extension.md`](docs/sep-draft-skills-extension.md). Comments and review happen on the PR. | ## Contributing From f57574896ff1c3a13c84f8bbc72fa346bf6aa739 Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 20:21:16 -0700 Subject: [PATCH 7/9] Link issues and meeting notes in Open Questions README row MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 🦉 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bf486b4..d013b03 100644 --- a/README.md +++ b/README.md @@ -34,7 +34,7 @@ See [problem-statement.md](docs/problem-statement.md) for full details. | [Why Skills Over MCP?](docs/why-and-when.md) | Value proposition and decision guide | | [Use Cases](docs/use-cases.md) | Key use cases driving this work | | [Approaches](docs/approaches.md) | Approaches being explored (not mutually exclusive) | -| [Open Questions](docs/open-questions.md) | Unresolved questions with community input | +| [Open Questions](docs/open-questions.md) | Unresolved questions with community input (see also [issues](https://github.com/modelcontextprotocol/experimental-ext-skills/issues) and [meeting notes](https://github.com/modelcontextprotocol/modelcontextprotocol/discussions/categories/meeting-notes-skills-over-mcp-wg)) | | [Experimental Findings](docs/experimental-findings.md) | Results from implementations and testing | | [Related Work](docs/related-work.md) | SEPs, implementations, and external resources | | [Decision Log](docs/decisions.md) | Record of key decisions with context and rationale | From d89a86ad5c6312375f55441b1410d8c1d2053ae6 Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 20:25:59 -0700 Subject: [PATCH 8/9] Surface SEP-2640 in README and related-work table order MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README: move the Skills Extension SEP from the bottom of the Repository Contents table to sit after Approaches, matching the narrative flow (framing → options → proposal → supporting material). related-work.md: lead the SEPs and Proposals table with SEP-2640 (this WG's headline proposal), followed by the prerequisite PR #2527. 🦉 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 2 +- docs/related-work.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d013b03..87451fd 100644 --- a/README.md +++ b/README.md @@ -34,11 +34,11 @@ See [problem-statement.md](docs/problem-statement.md) for full details. | [Why Skills Over MCP?](docs/why-and-when.md) | Value proposition and decision guide | | [Use Cases](docs/use-cases.md) | Key use cases driving this work | | [Approaches](docs/approaches.md) | Approaches being explored (not mutually exclusive) | +| [SEP-2640: Skills Extension](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | Proposal to serve skills over MCP via the Resources primitive. Original working draft: [`docs/sep-draft-skills-extension.md`](docs/sep-draft-skills-extension.md). Comments and review happen on the PR. | | [Open Questions](docs/open-questions.md) | Unresolved questions with community input (see also [issues](https://github.com/modelcontextprotocol/experimental-ext-skills/issues) and [meeting notes](https://github.com/modelcontextprotocol/modelcontextprotocol/discussions/categories/meeting-notes-skills-over-mcp-wg)) | | [Experimental Findings](docs/experimental-findings.md) | Results from implementations and testing | | [Related Work](docs/related-work.md) | SEPs, implementations, and external resources | | [Decision Log](docs/decisions.md) | Record of key decisions with context and rationale | -| [SEP-2640: Skills Extension](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | Proposal to serve skills over MCP via the Resources primitive. Original working draft: [`docs/sep-draft-skills-extension.md`](docs/sep-draft-skills-extension.md). Comments and review happen on the PR. | ## Contributing diff --git a/docs/related-work.md b/docs/related-work.md index 5ac8361..5bf692e 100644 --- a/docs/related-work.md +++ b/docs/related-work.md @@ -4,8 +4,8 @@ | Proposal | Venue | Description | | :--- | :--- | :--- | -| [PR #2527](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2527) | MCP Spec | Recommend clients expose resource read to models — prerequisite for the resources-based skills approach | | [SEP-2640 (Skills Extension)](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640) | MCP Spec | This WG's proposed extension: skills served over MCP using the Resources primitive and `skill://` URI scheme ([working draft](sep-draft-skills-extension.md)) | +| [PR #2527](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2527) | MCP Spec | Recommend clients expose resource read to models — prerequisite for the resources-based skills approach | | [skills.json format proposal](https://github.com/modelcontextprotocol/registry/discussions/895) | MCP Registry | Skills metadata in registry schema | | ~~[SEP-2093](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)~~ | MCP Spec | ~~Resource Contents Metadata and Capabilities: scoped `resources/list`, per-resource capabilities, `resources/metadata` endpoint~~ — **rejected** ([labeled upstream](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2093)) | | ~~[SEP-2076](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2076)~~ | MCP Spec | ~~Agent Skills as a first-class MCP primitive~~ — **closed** (2026-02-24, without merge) | From 891bacd1de789c41e74cd8465a60560d3baf0507 Mon Sep 17 00:00:00 2001 From: olaservo Date: Thu, 23 Apr 2026 20:31:27 -0700 Subject: [PATCH 9/9] Add 'Open work' link to README header pointing to open PRs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signals that alternative proposals, decisions, implementations, and other in-flight contributions are welcome — SEP-2640 is one direction, not the only one. 🦉 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 87451fd..48fe900 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,7 @@ **Project board:** [Skills Over MCP WG](https://github.com/orgs/modelcontextprotocol/projects/38/views/1) **Meeting notes:** [Skills Over MCP WG discussions](https://github.com/modelcontextprotocol/modelcontextprotocol/discussions/categories/meeting-notes-skills-over-mcp-wg) **Discord:** [#skills-over-mcp-wg](https://discord.com/channels/1358869848138059966/1464745826629976084) +**Open work:** [Pull requests](https://github.com/modelcontextprotocol/experimental-ext-skills/pulls) — proposals, decisions, implementations, and other in-flight contributions welcome. ## Why Skills Over MCP?