openspec-propose

Generate proposal.md, design.md, and tasks.md for a proposed change.

2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/tim-hub/powerball --skill openspec-propose-tim-hub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/tim-hub/powerball/tree/main/openspec-rewrite/skills/openspec-propose
Command: npx skills add https://github.com/tim-hub/powerball --skill openspec-propose-tim-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Propose a change and generate all related artifacts (proposal, design, and tasks) in a single streamlined workflow, reducing planning overhead and miscommunication.

Core Features & Use Cases

  • Single-step proposal: Create a complete change proposal with artifacts ready for review.
  • Artifact scaffolding: Automatically generate proposal.md, design.md, and tasks.md based on user input.
  • Guided implementation: Provides a clear path from proposal to actionable tasks, suitable for feature requests or bug fixes.

Quick Start

Ask what you want to build and then run the openspec flow to create a new change with all artifacts.

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 complete change proposal with design and tasks documents?

To generate a complete change proposal, you provide a clear feature request or bug fix description. The system then scaffolds all related artifacts, automatically outputting proposal.md, design.md, and tasks.md for review and implementation.

What is the best way to create proposal and design artifacts for feature requests?

The best way to create proposal and design artifacts is using a single-step workflow that processes your feature description into a templated, dependency-aware artifact set. This reduces planning overhead and prevents miscommunication.

Can I scaffold implementation tasks automatically from a bug fix description?

Yes, you can scaffold implementation tasks automatically from a bug fix description. The workflow processes your input and generates a tasks.md file that provides step-by-step guidance to move from proposal to actionable implementation.

Do I need any dependencies to run the openspec proposal workflow?

No, you do not need any dependencies to run the openspec proposal workflow. It operates independently to generate the full proposal, design, and tasks artifacts based solely on your provided feature or bug fix input.

Why does my design document need to be generated alongside the proposal?

Your design document is generated alongside the proposal to ensure technical alignment and reduce miscommunication. Delivering a dependency-aware artifact set in one step provides a clear, guided path from planning to implementation.

When should I use a single-step proposal generator instead of manual planning?

You should use a single-step proposal generator when you have a clear feature request or bug fix and need to reduce planning overhead. It delivers templated, dependency-aware artifacts that move you directly to implementation.