Black FridayBlack Friday starts early: 60% off SkillGild Pro

Code BFCM60Claim 60%

Black FridayBlack Friday starts early: 60% off SkillGild Pro

Claim 60%
SkillGild
Development

OpenSpec Propose

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

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.

Install the SkillGild CLI first. If you already have it, run skillgild update once.

  1. Install this skill for Claude Code.

    Terminal
    skillgild install openspec-propose --agent claude-code

    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

  1. Your agent starts a session. SkillGild checks your access and allowance, counts one run, and sends the skill's instructions for this task.
  2. Your agent does the work with its own model and tools, in your project. SkillGild makes no AI model call.
  3. 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.

Reviews

No reviews yet

Used OpenSpec Propose? Your rating helps the next person decide.

Be the first to rate OpenSpec Propose
Tap a star