(chore): Add /draft-sep skill to simplify how SEPs are written#2410
Open
(chore): Add /draft-sep skill to simplify how SEPs are written#2410
Conversation
Guides SEP authors through interview → research → gate → draft → PR.
Checks existing spec coverage via mcp-docs, prior art via
/search-mcp-github, overlapping SEPs, and design-principle fit before
filling the eight-section TEMPLATE.md. Writes seps/SEP-DRAFT-{slug}.md
and offers (with checkpoint) to open a draft PR that backfills the
SEP number.
:house: Remote-Dev: homespace
localden
changed the title
SEP-2133 (Final) established Extensions Track for extension SEPs, and SEP-1865 already uses it. TEMPLATE.md and sep-guidelines.mdx still list only three types — the skill now notes that discrepancy inline so the agent doesn't get confused when reading the template. :house: Remote-Dev: homespace
dsp-ant
previously approved these changes
Mar 17, 2026
🏠 Remote-Dev: homespace
dsp-ant
requested changes
Mar 26, 2026
Co-authored-by: David Soria Parra <167242713+dsp-ant@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a
/draft-sep <idea>skill to themcp-specplugin, sibling to/search-mcp-github.What it does
Guides an author through producing a SEP that conforms to
docs/community/sep-guidelines.mdxandseps/TEMPLATE.md, in six phases:mcp-docs, prior art via/search-mcp-github, overlap check againstseps/*.md, design-principle fit, schema touch-points, runtime exemplar sampling from Final-status SEPsseps/SEP-DRAFT-{slug}.md--draftPR, capture the number,git mv+ backfill in a second commitThe discuss-before-drafting nudge from the guidelines is surfaced at the top so cold SEPs get flagged early.
Files
plugins/mcp-spec/skills/draft-sep/SKILL.md— newplugins/mcp-spec/README.md— add/draft-sepentry