openspec-propose

Generate scaffolded change directories with proposal, design, and tasks artifacts.

43|1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/liyown/XHSSpec --skill openspec-propose-liyown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/liyown/XHSSpec/tree/main/.claude/skills/openspec-propose
Command: npx skills add https://github.com/liyown/XHSSpec --skill openspec-propose-liyown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose a new change - create the change and generate all artifacts in one step. It enables quickly describing what you want to build and getting a complete proposal with design, specs, and tasks ready for implementation.

Core Features & Use Cases

  • Generates a scaffolded change with artifacts: proposal.md (what & why), design.md (how), and tasks.md (implementation steps).
  • Provides an end-to-end workflow to go from user input to an apply-ready plan, including guidance to run openspec apply command.
  • Supports an interactive input step with a built-in AskUserQuestion prompt to clarify intent when input is vague.

Quick Start

Describe the change you want to work on in kebab-case to generate a complete proposal.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I generate a project proposal with design specs and tasks automatically?

To generate a project proposal with design specs and tasks automatically, describe your desired change in kebab-case. The workflow creates a scaffolded directory containing proposal.md, design.md, and tasks.md, preparing an apply-ready plan for implementation.

What is included in a scaffolded change proposal for project management?

A scaffolded change proposal includes three core artifacts: proposal.md detailing what and why, design.md explaining how, and tasks.md outlining implementation steps. This ensures a complete transition from intent to an apply-ready execution plan.

How do I start a change proposal when my project requirements are vague?

To start a change proposal with vague requirements, the workflow uses an interactive AskUserQuestion prompt. This built-in step clarifies your intent during input, ensuring the generated proposal, design, and tasks accurately reflect your goals.

Can I apply generated project tasks immediately after artifact creation?

Yes, you can apply generated project tasks immediately after artifact creation. The workflow guides input and artifact creation to achieve an apply-ready status, culminating in guidance to run the openspec apply command for implementation.

Do I need any dependencies to create design specs and change proposals?

No external dependencies are required to create design specs and change proposals. The workflow operates independently to scaffold the change directory and generate the proposal, design, and tasks artifacts for your project management needs.