openspec-propose

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

17|7|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/gqcn/openspec-practice --skill openspec-propose-gqcn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/gqcn/openspec-practice/tree/main/.agents/skills/openspec-propose
Command: npx skills add https://github.com/gqcn/openspec-practice --skill openspec-propose-gqcn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the initial change proposal process by generating all required artifacts in a single step, reducing manual coordination.

Core Features & Use Cases

  • Auto-create proposal.md (what & why)
  • Auto-generate design.md (how)
  • Auto-generate tasks.md (implementation steps)

Quick Start

Describe the desired change, then run openspec new change <name> to 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 a complete change proposal with design and tasks files in one step?

Deriving a kebab-case name from your input, this workflow automation generates proposal.md, design.md, and tasks.md simultaneously. The scaffold captures the what, why, how, and implementation steps for your change management process.

What is automated change management artifact generation and how does it work?

Automated artifact generation creates a structured scaffold containing proposal.md, design.md, and tasks.md from a single input. It derives a kebab-case name and populates the files to eliminate manual coordination during the initial change proposal process.

How do I apply the generated change proposal artifacts after they are created?

After the proposal artifacts are generated, you apply them using the /opsx:apply command. This guides the user through implementing the changes defined in the scaffolded proposal.md, design.md, and tasks.md files.

Can I use this workflow automation tool without installing external dependencies?

Yes, you can use this workflow automation tool without external dependencies because it operates independently. It directly generates the proposal.md, design.md, and tasks.md scaffold based solely on your input description.

What is the best way to automate creating a design document and task list for a new software change?

The best way to automate design document and task list creation is providing a description to this one-step proposal generator. It scaffolds design.md and tasks.md alongside proposal.md to fully document the change management process.

When do I need to generate a scaffold with proposal, design, and tasks files?

You need to generate this scaffold when initiating a new change management process. It provides a standardized structure for documenting the what, why, how, and implementation steps, reducing manual coordination for software engineering changes.