openspec-propose

Generate proposal.md, design.md, and tasks.md via the openspec CLI.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/jrmatherly/spacebot --skill openspec-propose-jrmatherly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/jrmatherly/spacebot/tree/main/.windsurf/skills/openspec-propose
Command: npx skills add https://github.com/jrmatherly/spacebot --skill openspec-propose-jrmatherly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rapidly creating well-structured change proposals, designs, and implementation tasks is time-consuming and error-prone when done manually; this Skill automates the end-to-end creation of those artifacts so teams can move from idea to implementation readiness in one flow.

Core Features & Use Cases

  • One-step artifact generation: Scaffolds a change with the openspec CLI and produces proposal.md, design.md, and tasks.md in dependency order.
  • Dependency-aware workflow: Queries artifact instructions, reads completed dependencies for context, and iterates until all implementation-required artifacts are done.
  • Interactive clarification and validation: Prompts the user when input is unclear and verifies files exist before proceeding, making it suitable for developer and product workflows that need reproducible change proposals.

Quick Start

Tell me what change you want to make and I will create a new openspec change and generate proposal.md, design.md, and tasks.md ready for review.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I automate change proposal generation for design specs and implementation tasks?

Generating change proposals requires creating proposal.md, design.md, and tasks.md based on artifact dependencies. This workflow queries instructions, reads completed dependencies for context, and iterates until all implementation-required artifacts are done.

How do I create proposal.md, design.md, and tasks.md files in the correct dependency order?

Creating proposal.md, design.md, and tasks.md in dependency order involves querying artifact instructions and reading completed dependencies for context. The workflow iterates through each file until all implementation-required artifacts are generated and ready for review.

Do I need the openspec CLI to scaffold changes and generate artifacts?

Yes, the openspec CLI is required to scaffold changes and retrieve artifact instructions. It provides the necessary structure to generate proposal.md, design.md, and tasks.md files accurately based on project dependencies.

What is the best way to prepare implementation tasks for developer and product workflows?

The best way to prepare implementation tasks is using an interactive clarification and validation workflow that generates design specs and tasks.md. It verifies files exist before proceeding, ensuring reproducible change proposals for developer and product teams.

Does the proposal generation workflow validate files and prompt for clarification?

Yes, the change proposal workflow validates files and prompts for clarification. It checks that files exist before proceeding and asks for input when instructions are unclear, ensuring artifact generation remains accurate and reproducible.

Why does manual change proposal creation fail for complex design specs?

Manual change proposal creation fails because rapidly generating well-structured design specs and tasks is time-consuming and error-prone. Automating the end-to-end creation of these artifacts ensures teams move from idea to implementation readiness in one consistent flow.