openspec-propose

Generate change proposals with design, specs, and task artifacts.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/captaincontrat/audio-recap --skill openspec-propose-captaincontrat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/captaincontrat/audio-recap/tree/main/.cursor/skills/openspec-propose
Command: npx skills add https://github.com/captaincontrat/audio-recap --skill openspec-propose-captaincontrat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of a complete change proposal, generating design docs, task lists, and implementation guidance in one cohesive workflow.

Core Features & Use Cases

  • Artifact scaffolding: From a user-provided change name or description, it scaffolds a full set of artifacts (proposal.md, design.md, tasks.md) with a consistent structure.
  • Dependency-aware sequencing: Automatically determines the execution order based on declared dependencies and tracks progress until all required artifacts are ready.
  • Guided execution: Provides step-by-step instructions and guardrails to ensure coherent proposals and safe progression to implementation.

Quick Start

Describe the change you want to build and let OpenSpec generate the full proposal with design, tasks, and acceptance criteria.

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 project proposal with design and tasks in one step?

To generate a project proposal, you provide a change name or description and the system scaffolds a full set of artifacts including design docs, task lists, and implementation guidance in a cohesive workflow.

What is dependency-aware sequencing for change management proposals?

Dependency-aware sequencing automatically determines the execution order of artifacts based on declared dependencies and tracks progress until all required proposal documents are fully generated.

How do I scaffold design docs and task lists from a change description?

You input a brief change description, and the tool scaffolds structured artifacts like proposal.md, design.md, and tasks.md automatically, ensuring consistent documentation across the project.

Do I need to manually track progress when generating multiple project artifacts?

No, you do not need to manually track progress. The system tracks dependencies and artifact readiness automatically, prompting for input only when needed to ensure coherent outputs.

What is the best way to move from a change proposal to implementation?

The best way to move to implementation is to follow the guided execution guardrails during proposal generation, then run the apply command after all design and task artifacts are fully ready.