openspec-propose

Scaffold OpenSpec changes and generate proposal, design, and tasks artifacts.

9|2|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/typemd/typemd --skill openspec-propose-typemd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/typemd/typemd/tree/main/.claude/skills/openspec-propose
Command: npx skills add https://github.com/typemd/typemd --skill openspec-propose-typemd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose a new change and generate all related artifacts in a single step, eliminating back-and-forth scoping and waiting for separate runs.

Core Features & Use Cases

  • One-step change proposal: auto-create proposal.md, design.md, and tasks.md based on user input.
  • Derives a kebab-case change name from user input and scaffolds openspec/changes/<name>.
  • Manages artifact generation order, dependencies, and readiness, ready for /opsx:apply.
  • Supports iterative refinement by prompting for clarifications when input is ambiguous.

Quick Start

Provide a change description or name to begin, and I will scaffold the change and generate proposal, design, and task artifacts.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I auto-generate change proposals and design artifacts for openspec?

Auto-generating change proposals for openspec requires providing a change description to scaffold the directory and compute the artifact generation order. This process creates proposal.md, design.md, and tasks.md files simultaneously in a single step.

What is the best way to scaffold openspec/changes directories from a description?

Scaffolding openspec/changes directories is handled by deriving a kebab-case change name from your input description. The system creates the directory structure and prepares the proposal, design, and task artifacts for subsequent apply workflows.

Can I generate proposal.md, design.md, and tasks.md in a single step?

Generating proposal.md, design.md, and tasks.md in a single step is the core function of this automation. It eliminates back-and-forth scoping and waiting for separate runs by managing artifact dependencies and readiness instantly.

How does the change scaffold handle ambiguous input or missing dependencies?

When change scaffold input is ambiguous, the system prompts for clarification to iteratively refine the proposal. It enforces dependencies and computes the correct artifact generation order to ensure readiness before applying changes.

Do I need a specific CLI tool to manage openspec change management artifacts?

Managing openspec change management artifacts does not require external CLI tools beyond providing your change description. The automation exposes status, instruction, and apply workflows directly to handle the proposal and artifact generation lifecycle.