openspec-propose

Generates complete OpenSpec change proposals with design, specs, and task artifacts.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/feidon/vss --skill openspec-propose-feidon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/feidon/vss/tree/main/frontend/.claude/skills/openspec-propose
Command: npx skills add https://github.com/feidon/vss --skill openspec-propose-feidon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a full change proposal with design documents, specifications, and implementation tasks is slow and inconsistent. This Skill turns a short description of what you want to build into a complete, structured OpenSpec change ready for implementation. ## Core Features & Use Cases - One-Step Proposal Generation: Creates the change directory and generates proposal.md, design.md, and tasks.md artifacts in dependency order using the openspec CLI. - Schema-Driven Artifacts: Follows per-artifact instructions, templates, and rules from openspec instructions so every output matches the project schema. - Interactive Clarification: Asks the user what they want to build when input is unclear, and derives kebab-case change names automatically. - Use Case: Describe "add user authentication" and receive a scaffolded change at openspec/changes/add-user-auth/ with all artifacts ready, then run /opsx:apply to implement. ## Quick Start Ask the assistant to propose a new change by describing what you want to build, for example "propose a change to add user authentication".

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I create an OpenSpec change proposal?▼

Describe what you want to build and the Skill runs `openspec new change` with a derived kebab-case name, then generates proposal.md, design.md, and tasks.md in dependency order using `openspec instructions` for each artifact.

What artifacts does an OpenSpec 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 reported by `openspec status`.

Does openspec-propose require the openspec CLI?▼

Yes, the Skill requires the openspec CLI to be installed. It shells out to commands like `openspec new change`, `openspec status --json`, and `openspec instructions` to scaffold and generate artifacts.

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 with a different name, rather than overwriting or failing silently.

How do I implement the change after proposing it?▼

Once all required artifacts show status done, run `/opsx:apply` or ask the assistant to implement. The Skill verifies each artifact file exists and confirms readiness before prompting this next step.