skills.rest
capella-hotel-group
capella-hotel-groupOFFICIAL
Explore all skills by this author →
GitHub

openspec-propose

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

Updated Apr 6, 2026
Search Tags:#cli#spec-driven development#openspec#task generation#design documents#change proposal
One-click install
npx skills add https://github.com/capella-hotel-group/capella-hotel-group-poc --skill openspec-propose-capella-hotel-group
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/capella-hotel-group/capella-hotel-group-poc/tree/main/.github/skills/openspec-propose
Command: npx skills add https://github.com/capella-hotel-group/capella-hotel-group-poc --skill openspec-propose-capella-hotel-group

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, implementation-ready change proposal normally requires manually writing proposal documents, design notes, and task breakdowns. This Skill automates that entire flow through the OpenSpec CLI, producing all required artifacts in one guided step. ## Core Features & Use Cases - One-Step Change Scaffolding: Creates a new change directory via openspec new change and derives a kebab-case name from a plain-language description. - Dependency-Aware Artifact Generation: Reads openspec status and openspec instructions JSON output to build proposal.md, design.md, and tasks.md in the correct dependency order. - Progress Tracking and Verification: Uses todo tracking and re-checks artifact status until every artifact required for implementation is marked done. - Use Case: A developer says "add user authentication" and receives a complete openspec/changes/add-user-auth/ change with proposal, design, and tasks ready to implement via /opsx:apply. ## Quick Start Ask the assistant to propose a new change for the feature you want to build, for example by describing the feature and letting it run the openspec-propose workflow.

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 from a feature idea?▼

Describe what you want to build in plain language and the workflow derives a kebab-case change name, runs `openspec new change`, then generates proposal.md, design.md, and tasks.md in dependency order using the openspec CLI.

What artifacts does an OpenSpec change proposal include?▼

A complete 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 installed?▼

Yes, the workflow depends entirely on the openspec CLI for scaffolding changes, reporting artifact status, and providing per-artifact instructions. Without the CLI installed, none of the generation steps can run.

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

The workflow 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 the proposal is generated?▼

Once all apply-required artifacts show status done, run `/opsx:apply` or ask the assistant to implement, which starts executing the tasks defined in tasks.md.

Related Skills

Explore More Software Engineering Skills→
wooyekwooyek

dev10x-jtbd

Generate Job Stories from issue tracker tickets and PR diffs.

Community
Intermediate
jankneumannjankneumann
4

openspec-onboard

Guide users through the OpenSpec workflow cycle with CLI commands.

Community
Intermediate
stoodderstoodder
1

propose-spec

Generate proposed specification documents from project context and open a pull request.

Community
Advanced
linaproailinaproai
147

openspec-propose

Generate proposal, design, and task artifacts via the openspec CLI.

Official
Advanced