openspec-propose

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

1|1|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/33may/robotics --skill openspec-propose-33may
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/33may/robotics/tree/main/humanoid/.claude/skills/openspec-propose
Command: npx skills add https://github.com/33may/robotics --skill openspec-propose-33may

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 automates the entire OpenSpec proposal workflow so a single description of what you want to build produces all required artifacts in one step. ## Core Features & Use Cases - One-Step Proposal Generation: Creates the change scaffold and generates proposal.md, design.md, and tasks.md artifacts in dependency order. - Schema-Driven Artifacts: Uses the openspec CLI's instructions and templates so every artifact follows the project's defined structure and rules. - Dependency-Aware Sequencing: Reads completed dependency artifacts for context and tracks progress until all apply-required artifacts are done. - Use Case: Describe "add user authentication" and receive a ready-to-implement change with proposal, design, and task breakdown, 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 user authentication to the API.

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 or provide a kebab-case change name. The Skill runs openspec new change to scaffold the change, then generates proposal, design, and tasks artifacts in dependency order until the change is apply-ready.

What artifacts does an OpenSpec proposal include?

A typical proposal 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, and openspec instructions to scaffold changes and resolve artifact templates and output paths.

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 apply-required artifacts show status done, run /opsx:apply or ask the assistant to implement. The tasks.md artifact contains the ordered implementation steps for the change.