openspec-propose

Generate proposal.md, design.md, and tasks.md artifacts for a software change.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/garethbaumgart/mental-metal --skill openspec-propose-garethbaumgart
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/garethbaumgart/mental-metal/tree/main/.github/skills/openspec-propose
Command: npx skills add https://github.com/garethbaumgart/mental-metal --skill openspec-propose-garethbaumgart

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly turn a vague user request into a complete change proposal, including design, specs, and implementation tasks, all in one cohesive workflow.

Core Features & Use Cases

  • Generates a scaffolded change at openspec/changes/<name>/ with .openspec.yaml.
  • Produces artifacts: proposal.md, design.md, tasks.md, and coordinates their creation in dependency order.
  • Provides an interactive flow to derive a kebab-case change name from user input and to apply the artifacts with /opsx:apply.

Quick Start

Run the workflow to create a new change by providing a kebab-case name.

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

To generate a software change proposal in one step, use an automated workflow that scaffolds a directory and produces proposal.md, design.md, and tasks.md artifacts sequentially. This ensures all change documents are created in dependency order for immediate implementation.

What is the process for turning a vague feature request into a structured specification?

Turning a vague request into a structured specification involves an interactive flow that derives a kebab-case name from your description, then auto-generates matching proposal, design, and task files within a dedicated openspec directory.

How do I scaffold an openspec change directory and prepare artifacts for implementation?

Scaffolding an openspec change directory requires running an automated proposal workflow that creates a folder with a .openspec.yaml file and generates the necessary markdown artifacts, preparing the entire change for the apply phase.

Do I need to manually create proposal, design, and tasks files separately for a new software change?

You do not need to manually create proposal, design, and tasks files separately. An automated artifact-generation workflow coordinates their creation in a single step, ensuring proper dependency order and formatting before implementation.

What is the best way to automate design document and task generation from a feature description?

The best way to automate design document and task generation is using a single-step proposal workflow that takes a feature description, derives a kebab-case identifier, and scaffolds all required markdown artifacts in dependency order.