openspec-propose

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

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/shrek-abaper/sap-nexus-agent --skill openspec-propose-shrek-abaper
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/shrek-abaper/sap-nexus-agent/tree/main/.comet/skills/skills/openspec-propose
Command: npx skills add https://github.com/shrek-abaper/sap-nexus-agent --skill openspec-propose-shrek-abaper

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 in one step. ## Core Features & Use Cases - One-Step Change Creation: Runs the openspec CLI to scaffold a change directory and generate all required artifacts (proposal.md, design.md, tasks.md) in dependency order. - Schema-Driven Artifacts: Reads per-artifact instructions, templates, and rules from the openspec CLI so every output file follows the project's specification schema. - Interactive Clarification: Asks open-ended questions when the request is unclear and derives kebab-case change names automatically. - Use Case: Describe "add user authentication" and receive a ready-to-implement change at openspec/changes/add-user-auth/ with proposal, design, and tasks files, then run /opsx:apply to start implementation. ## Quick Start Ask the assistant to propose a new change by describing what you want to build, for example: propose a change to add OAuth login to the app.

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 typical change 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 depends on the openspec CLI being installed. It shells out to commands like openspec new change, openspec status, and openspec instructions to scaffold and populate the change directory.

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 start implementing after the proposal is created?▼

Once all apply-required artifacts show status done, run /opsx:apply or ask the assistant to implement. The tasks.md file then drives the implementation steps.