openspec-propose

Generates complete change proposals with design, specs, and tasks via the openspec CLI.

4|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/NEETROF/cymbra --skill openspec-propose-neetrof
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/NEETROF/cymbra/tree/main/.cursor/skills/openspec-propose
Command: npx skills add https://github.com/NEETROF/cymbra --skill openspec-propose-neetrof

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a change proposal by hand means drafting the proposal, design document, and task list separately and keeping them consistent. This Skill turns a short description of what you want to build into a complete, structured change proposal in one step. ## Core Features & Use Cases - One-step proposal generation: Creates the change scaffold and all required artifacts (proposal.md, design.md, tasks.md) through the openspec CLI. - Dependency-aware artifact ordering: Reads the openspec status JSON to build artifacts in the correct dependency order until the change is apply-ready. - Schema-driven output: Follows per-artifact templates, instructions, and rules returned by the CLI so each file matches the expected structure. - Use Case: Describe "add user authentication" and receive a kebab-case change directory containing a proposal explaining the what and why, a design document covering the how, and a tasks list ready for implementation. ## Quick Start Ask the assistant to propose a change for adding user authentication and it will generate the full proposal, design, and tasks artifacts.

Frequently Asked Questions about openspec-propose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a change proposal with openspec?▼

Describe what you want to build and the skill derives a kebab-case name, runs openspec new change, then generates proposal.md, design.md, and tasks.md in dependency order. Run openspec status to confirm the change is apply-ready.

What artifacts does an openspec change proposal include?▼

A proposal typically includes proposal.md covering what and why, design.md covering how, and tasks.md listing implementation steps. The exact set is determined by the schema's applyRequires field returned by openspec status.

Does openspec-propose require the openspec CLI installed?▼

Yes, the skill shells out to the openspec CLI for scaffolding, status, and instructions, so the CLI must be installed and available. The skill's compatibility field explicitly states it requires openspec.

What happens if a change with the same name already exists?▼

The skill asks whether you want to continue the existing change or create a new one instead of overwriting it. This guardrail prevents accidental duplication of in-progress proposals.

How do I implement the change after the proposal is created?▼

Once all required artifacts are done, run the apply command (such as /opsx:apply) or ask the assistant to implement. The tasks.md file then drives the implementation work.