Turn a feature request into an OpenSpec change before any code is written: proposal, delta specs, design and implementation tasks, grounded in the project's existing specs.
25 free runs a month
Runs in your agent, private tools on SkillGild
v1.1.0
SkillGild
$ skillgild install openspec-propose
Works with
Claude Code
Codex
Cursor
Gemini CLI
Antigravity
and any MCP client
Based on OpenSpec by Fission AI (MIT)
Original skill by Fission AI · MIT
Gallery
Original skill by Fission AI · MIT
What you get
An OpenSpec change proposal grounded in your project
Delta specs and a design for the change
Implementation tasks ready for your agent to work through
Requirements
The OpenSpec CLI
Install the OpenSpec Propose skill
Choose your agent and run one command. SkillGild signs you in when needed and connects the skill for you.
On first use, approve the sign-in request in your browser. SkillGild connects Claude Code automatically. Restart or reload your agent, then ask it to use this skill.
Developer detailsAPI examples, server tools and input schemas
How it runs
Your agent starts a session. SkillGild checks your access and allowance, counts one run, and sends the skill's instructions for this task.
Your agent does the work with its own model and tools, in your project. SkillGild makes no AI model call.
Private steps run on SkillGild. Your agent calls the server tools below and gets their results. The tool code never leaves SkillGild, and tool input is not stored.
Use it from code
Start a session, call its tools, then end it. Create an API key under Account and pass it as a bearer token.
Terminal
# Prints the session ID, its tools and the instructions for your agent
skillgild session openspec-propose
skillgild call <session-id> validate_change --input '{"change_name":"add-password-reset","proposal":"## Why\nUsers who forget their password are locked out and must contact support.\n\n## What Changes\n- Add password reset by email\n","tasks":"## 1. Reset\n- [ ] 1.1 Add endpoint\n","specs":[{"path":"specs/auth/spec.md","content":"## ADDED Requirements\n\n### Requirement: Password reset\nThe system SHALL email a reset link.\n\n#### Scenario: Known address\n- **WHEN** a user requests a reset\n- **THEN** a link is emailed\n"}]}'
skillgild end <session-id>
Server tools
Each call uses one of the session's tool calls.
validate_changeValidate an OpenSpec change
Checks a proposed OpenSpec change the way `openspec validate` does: change name, the proposal's Why and What Changes sections, delta spec sections (ADDED/MODIFIED/REMOVED/RENAMED Requirements), SHALL/MUST requirement text, scenarios and task checkboxes. Checks structure only; it does not read the project or judge whether the plan is right.
FieldTypeNotes
change_nameRequiredstringUp to 120 characters
specsRequiredarrayNo extra rules.
proposalstringUp to 60000 characters
skip_specsbooleanNo extra rules.
tasksstringUp to 60000 characters
Questions
How do I install the OpenSpec Propose skill in Claude Code?
Install or update the SkillGild CLI, then run skillgild install openspec-propose --agent claude-code. It signs you in when needed and registers the MCP connection automatically. Use --agent codex, cursor or gemini-cli for other clients. It installs as a skill, so there is no separate Claude Code plugin to add, and the no-code quickstart can have your agent do these steps for you.
Is this the same as /opsx:propose?
Yes. /opsx:propose is OpenSpec's command for this workflow; Cursor and GitHub Copilot spell it /opsx-propose and Codex $openspec-propose. Running openspec init prints the right form for your tool. If you are not sure what to build yet, OpenSpec's /opsx:explore comes first.
When does OpenSpec Propose run?
When you describe a feature you want built, or say "openspec propose". It writes every artifact the change needs in one step, before any code is written.
Is the OpenSpec Propose skill free?
Yes. Free skills include 25 runs a month, reset on the 1st. Your agent's own model usage is billed by your AI provider, not SkillGild.
Related guides
Setup steps and worked examples for this kind of skill.