openspec-propose

Generate proposal.md, design.md, and tasks.md via OpenSpec CLI.

114|47|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/huangjia2019/sdd-in-action --skill openspec-propose-huangjia2019
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/huangjia2019/sdd-in-action/tree/main/week2/code/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/huangjia2019/sdd-in-action --skill openspec-propose-huangjia2019

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts a brief request or idea into a complete, implementation-ready change package by generating the proposal, design, and task artifacts automatically and in dependency order, removing manual artifact coordination.

Core Features & Use Cases

  • One-step artifact generation: scaffolds a change and creates proposal.md, design.md, and tasks.md for implementation.
  • Dependency-aware workflow: uses openspec status and instructions to order work, read dependencies, and only create artifacts when prerequisites are satisfied.
  • Interactive clarification and tracking: asks clarifying questions when input is unclear and reports progress for each created artifact.
  • Use Case: Quickly turn a product request like "add user authentication" into a change directory with design, spec, and task artifacts ready for engineers.

Quick Start

Propose a change named add-user-auth to generate proposal, design, and tasks ready for implementation.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I generate proposal, design, and tasks artifacts for a new feature automatically?

To generate change artifacts automatically, describe your feature or fix request and the tool scaffolds a complete change directory, producing proposal.md, design.md, and tasks.md files in dependency order for immediate implementation.

How does the OpenSpec CLI create implementation-ready change packages?

The OpenSpec CLI creates change packages by using status and instructions commands to fetch artifact dependencies, ordering the work, and only generating proposal, design, and tasks files when prerequisites are satisfied.

Can I turn a brief product request into a full change directory with specs and tasks?

Yes, you can turn a brief product request into a full change directory by providing a short feature description, which triggers interactive clarification, scaffolding, and generation of ready-to-implement spec and task artifacts.

What is the best way to scaffold change proposals in dependency order?

The best way to scaffold change proposals in dependency order is using an automated workflow that reads artifact prerequisites and only creates the proposal, design, and tasks files when their respective dependencies are met.

Do I need to manually coordinate proposal, design, and tasks files when using OpenSpec?

No, you do not need to manually coordinate proposal, design, and tasks files, because the automated dependency-aware workflow reads instructions, honors artifact dependencies, and reports progress for each created file.

Why does the change proposal generation ask clarifying questions during the process?

Change proposal generation asks clarifying questions during the process to resolve unclear input, ensuring the automatically generated proposal, design, and tasks artifacts accurately reflect the intended feature or fix before implementation.