openspec-propose

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

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/ai-for-war/war_mind_fe --skill openspec-propose-ai-for-war
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/ai-for-war/war_mind_fe/tree/main/.agents/skills/openspec-propose
Command: npx skills add https://github.com/ai-for-war/war_mind_fe --skill openspec-propose-ai-for-war

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Drafting a structured change proposal with design documents, specifications, and implementation tasks requires coordinating multiple artifacts in the right order, which is slow and error-prone when done manually. ## Core Features & Use Cases - One-Step Proposal Generation: Creates a change directory and generates proposal.md, design.md, and tasks.md in a single workflow using the openspec CLI. - Dependency-Aware Artifact Creation: Reads the artifact build order from openspec status and generates each artifact only after its dependencies are complete. - Interactive Clarification: Asks the user what they want to build when the request is unclear, and derives a kebab-case change name automatically. - Use Case: Describe a feature like "add user authentication" and receive a fully scaffolded change at openspec/changes/add-user-auth/ with all artifacts ready for implementation. ## Quick Start Ask the assistant to propose a new change by describing what you want to build, for example requesting a proposal for adding 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` to scaffold the change, then generates proposal.md, design.md, and tasks.md in dependency order. A kebab-case name is derived from your description if you do not provide one.

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 openspec CLI must be installed and available. The skill calls 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. It does not overwrite or merge changes automatically.

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

Once all required artifacts show status done, run /opsx:apply or ask the assistant to implement. The tasks.md file contains the ordered implementation steps for the change.