Skip to content

Update docs to reflect convention-to-SEP evolution; link to charter#78

Merged
SamMorrowDrums merged 3 commits intomodelcontextprotocol:mainfrom
olaservo:update-docs-sep-evolution
Apr 15, 2026
Merged

Update docs to reflect convention-to-SEP evolution; link to charter#78
SamMorrowDrums merged 3 commits intomodelcontextprotocol:mainfrom
olaservo:update-docs-sep-evolution

Conversation

@olaservo
Copy link
Copy Markdown
Member

Summary

Three related doc updates:

  1. Reflect convention-to-SEP evolution — The "MCP Skills Convention v0.1" (issue Draft MCP Skills Convention v0.1 #43, now closed) graduated into the draft Skills Extension SEP (Add draft SEP for Skills Extension #69). Updates the README work tracking row, adds status notes to approaches.md (Central Tension and Approach 6), and updates skill-uri-scheme.md from "Draft" to "Incorporated into SEP."

  2. Cross-reference docs to tracking issues — Adds "Tracked in" and "See also" links throughout open-questions.md, approaches.md, use-cases.md, and experimental-findings.md so readers can find active discussion without hunting through the issues list. Supersedes Link GitHub issues from docs to reduce duplicate tracking #56.

  3. Slim README to link to charter — Once the IG charter lands, it becomes the canonical source for mission, scope, membership, work items, and success criteria. Remove duplicate sections from README and link to the charter instead, reducing drift risk. README now focuses on repo-specific content (experimental banner, why/problem statement, repository contents table, contributing link).

Dependencies

⚠️ Blocked on modelcontextprotocol#2568 — The README links to modelcontextprotocol.io/community/skills-over-mcp/charter, which will 404 until the charter PR is merged and published. Holding as draft until that lands.

Related

Test plan

  • Charter PR (modelcontextprotocol#2568) merged and published
  • Verify the charter link in README resolves
  • Visual review of rendered markdown on all modified files

🦉 Generated with Claude Code

olaservo and others added 3 commits April 13, 2026 20:21
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>
Link open questions, approaches, use cases, and experimental findings
to their corresponding GitHub issues so readers can find the active
discussion without hunting through the issues list.

- open-questions.md: "Tracked in" and "See also" links on Q1, Q4, Q5,
  Q7, Q8, Q12, Q13
- approaches.md: "See also" links on Approach 3, distribution section,
  and sampling variant
- use-cases.md: "See also" links on UC3 (multi-server) and UC4
  (progressive disclosure)
- experimental-findings.md: contribution template note and skill
  reliability link

Supersedes modelcontextprotocol#56.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The charter at modelcontextprotocol.io/community/skills-over-mcp/charter
is the canonical source for mission, scope, membership, work items, and
success criteria. Remove duplicate sections from README and link to the
charter instead, reducing drift risk.

README now focuses on repo-specific content:
- Experimental banner
- Quick links (charter, project board, meeting notes, Discord)
- Why Skills Over MCP? (entrypoint)
- Problem Statement (brief, links to docs/)
- Repository Contents table
- Contributing link

Removed (now in charter): Mission, Scope, Stakeholder Groups,
Facilitators, Lifecycle, Work Tracking, Success Criteria.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@olaservo olaservo marked this pull request as ready for review April 14, 2026 17:46
@olaservo olaservo requested a review from a team as a code owner April 14, 2026 17:46
@SamMorrowDrums
Copy link
Copy Markdown

I think this is much cleaner, going ahead and merging.

@SamMorrowDrums SamMorrowDrums merged commit 8a6ad39 into modelcontextprotocol:main Apr 15, 2026
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.

2 participants