openspec-propose

Scaffold proposal.md, design.md, and tasks.md for software changes.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/chuangkevin/project-bridge --skill openspec-propose-chuangkevin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/chuangkevin/project-bridge/tree/main/.gemini/skills/openspec-propose
Command: npx skills add https://github.com/chuangkevin/project-bridge --skill openspec-propose-chuangkevin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rapidly converts a user idea or brief into a fully scaffolded change with all implementation artifacts, removing manual scaffolding and coordination overhead when planning features or fixes. It ensures proposals, design notes, and task lists are created in correct dependency order and ready for implementation.

Core Features & Use Cases

  • One-step proposal generation: Creates a change scaffold and generates proposal.md, design.md, and tasks.md automatically.
  • Dependency-aware artifact sequencing: Queries openspec status and instructions, resolves artifact dependencies, and writes artifacts in the correct order.
  • Interactive clarifications & progress tracking: Asks follow-up questions when input is unclear and reports progress via TodoWrite.
  • Use Case: A PM or engineer describes a new feature and gets a ready-to-implement change with design and task breakdown without manual file creation.

Quick Start

Propose a new 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 automatically generate a change proposal with design and task files for a new feature?

To automatically generate a change proposal, you describe a feature or bug to get a single-step proposal that creates proposal.md, design.md, and tasks.md artifacts simultaneously. This scaffolds complete change artifacts in correct dependency order for immediate implementation readiness.

What is dependency-aware artifact sequencing when scaffolding software change proposals?

Dependency-aware artifact sequencing queries openspec status and instructions to resolve artifact dependencies, then writes proposal.md, design.md, and tasks.md files in the correct order. This ensures your change scaffold has proper structural relationships before implementation begins.

Do I need the openspec CLI to scaffold proposal, design, and tasks files?

Yes, you need the openspec CLI to create and inspect changes, parse instruction JSON, and write artifact files under the openspec/changes/<name> directory. The CLI handles the underlying file operations required to scaffold complete change artifacts.

Can I use a brief idea to scaffold a complete software change with implementation tasks?

Yes, you can convert a brief user idea into a fully scaffolded change with all implementation artifacts in one step. The process asks interactive clarifications when input is unclear, then generates the proposal, design notes, and task breakdown automatically without manual file creation.

What is the best way to remove manual scaffolding overhead when planning software fixes?

The best way to remove manual scaffolding overhead is using an automated one-step proposal generation process that creates proposal.md, design.md, and tasks.md files. This eliminates manual file creation and coordination when planning features or fixes by ensuring artifacts are dependency-ordered.

Why does my change proposal generation ask follow-up questions before creating artifacts?

Change proposal generation asks interactive clarifications when your input is unclear to ensure accurate artifact creation. It also reports progress via TodoWrite during the process, guaranteeing the resulting proposal.md, design.md, and tasks.md files accurately reflect your intended feature or bug fix.