openspec-propose

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

84|18|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/intent-driven-dev/openspec-schemas --skill openspec-propose-intent-driven-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/intent-driven-dev/openspec-schemas/tree/main/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/intent-driven-dev/openspec-schemas --skill openspec-propose-intent-driven-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proposes a new change and generates all required artifacts in one step, eliminating scattered planning and manual artifact creation.

Core Features & Use Cases

  • Single-step change proposal: scaffold a new change and produce proposal.md, design.md, and tasks.md in openspec/changes/<name>/.
  • Input-driven naming: derives a kebab-case change name from user input for consistent referencing.
  • Guided execution: uses an interactive workflow to gather input, create artifacts in dependency order, and prepare them for implementation.

Quick Start

Describe the change you want to work on and I will generate a complete proposal with design, specs, and tasks.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I generate design and specification artifacts for a new software change proposal in one step?

To generate a change proposal, you describe the change you want and the system derives a kebab-case name to scaffold proposal.md, design.md, and tasks.md in openspec/changes/<name>/ simultaneously. This eliminates scattered planning and manual artifact creation by producing all required documents in a single interactive workflow.

What is the best way to align a product development team on task planning and specifications before implementation?

The best way to align a product development team is generating a complete change proposal with design, specs, and tasks in one step. This creates a shared set of artifacts in dependency order, ensuring everyone references the same proposal.md, design.md, and tasks.md before implementation begins.

How do I scaffold an openspec change directory with proposal, design, and tasks files?

You scaffold an openspec change directory by providing a description of your intended change. The system automatically derives a kebab-case change name and creates the openspec/changes/<name>/ directory populated with proposal.md, design.md, and tasks.md through an interactive workflow.

Do I need to manually name my change proposals when generating specifications and tasks?

No, you do not need to manually name change proposals because the system uses input-driven naming. It automatically derives a consistent kebab-case change name directly from your descriptive input, ensuring standardized referencing across the generated artifacts.

How do I finalize implementation after generating a complete change proposal with design and tasks?

To finalize implementation after generating a complete change proposal, you use the /opsx-apply workflow. This workflow takes the prepared proposal.md, design.md, and tasks.md artifacts and transitions them into the actual implementation phase.