openspec-proposal-creation — Claude Code skill: spec-driven change
Builds a structured change proposal: proposal.md, tasks.md and spec-delta.md with requirements in EARS format. Useful when a feature needs writing down before anyone codes it.
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a claude-codeWhat openspec-proposal-creation does
The skill walks the agent through eight steps. First it looks at what specs already exist under spec/specs and which changes are open in spec/changes, then picks an identifier like add-user-authentication and checks it is free. After that it scaffolds spec/changes/{change-id}/specs/{capability-name} and fills it with three files.
proposal.md covers why the change is happening, what shifts and who gets affected. tasks.md is a numbered implementation checklist, typically 5 to 15 items, including testing and documentation work. The critical piece is spec-delta.md: requirements follow EARS syntax under ## ADDED Requirements, ## MODIFIED Requirements and ## REMOVED Requirements, and each requirement gets a scenario written as #### Scenario:.
Before handing the proposal over, the skill runs validation: it counts delta operations with grep and checks requirement and scenario headers. Skip that step and the structure drifts, which means redoing the proposal. Runs in Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.
What it helps with
- spec a new feature before writing code
- capture a breaking change and its impact
- build an implementation checklist with tests
- document removal of a deprecated capability
- validate proposal structure before approval
Example prompts for the agent
- create an openspec proposal for adding user authentication
- review existing specs and suggest a change ID for the new feature
- write a spec delta in EARS format for the API rate limit change
How to install openspec-proposal-creation
1Skills CLI (Vercel)
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a claude-code2Manually: put the files in place
~/.claude/skills/openspec-proposal-creation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/openspec-proposal-creation/
1Skills CLI (Vercel)
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a codex2Manually: put the files in place
.agents/skills/openspec-proposal-creation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a cursor2Manually: put the files in place
.cursor/skills/openspec-proposal-creation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install forztf/open-skilled-sdd openspec-proposal-creation2Manually: put the files in place
.github/skills/openspec-proposal-creation/SKILL.md1Skills CLI (Vercel)
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a gemini-cli2Platform CLI
gemini skills install https://github.com/forztf/open-skilled-sdd --path skills/openspec-proposal-creationManually: put the files in place
.devin/skills/openspec-proposal-creation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about openspec-proposal-creation
How do I install openspec-proposal-creation in Claude?
Run npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a claude-code. The skill file then lands at ~/.claude/skills/openspec-proposal-creation/SKILL.md.
What does openspec-proposal-creation do?
It creates a change proposal following spec-driven development: proposal.md with Why/What/Impact sections, tasks.md as an implementation checklist, and spec-delta.md with requirements in EARS format.
Which platforms are supported?
Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Each platform has its own install command in the repository.
