openspec-propose

Generate proposal, design, and task artifacts under openspec/changes/<name>.

1|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/oinani0721/canvas-learning-system --skill openspec-propose-oinani0721
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/oinani0721/canvas-learning-system/tree/main/.claude/skills/openspec-propose
Command: npx skills add https://github.com/oinani0721/canvas-learning-system --skill openspec-propose-oinani0721

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose and scaffold a complete change with all artifacts in one step, eliminating manual coordination and multiple tool invocations.

Core Features & Use Cases

  • Generate a concise change proposal (proposal.md), a design document (design.md), and a task list (tasks.md) from a user description.
  • Create a ready-to-implement scaffold under openspec/changes/<kebab-name> and track progress with openspec status.
  • Derive a kebab-case change name from natural language input, scaffold the change, and provide an automated workflow for implementation.

Quick Start

Describe the desired change and run the openspec new change "<name>" to automatically generate all artifacts in one step.

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 change proposal, design, and task list in one step?

To generate a change proposal in one step, run openspec new change with a description. It automatically scaffolds the openspec/changes directory and creates proposal.md, design.md, and tasks.md artifacts.

What is automated scaffolding for change proposals and when do I need it?

Automated scaffolding for change proposals eliminates manual file coordination by generating standardized proposal, design, and task documents. You need it when planning software changes that require consistent tracking from description to implementation.

How do I create a kebab-case change name from a natural language description?

To create a kebab-case change name, provide a natural language description of your desired change. The workflow derives a kebab-case name automatically, scaffolds the directory, and coordinates artifact generation without manual naming.

Can I track implementation progress after generating change artifacts?

Yes, you can track implementation progress after generating artifacts by running openspec status. This checks the scaffolding created under openspec/changes and monitors the workflow status of your generated proposal, design, and tasks.

Does openspec workflow require any dependencies to scaffold changes?

Openspec workflow requires no external dependencies to scaffold changes. It operates independently to derive kebab-case names, scaffold directories under openspec/changes, and coordinate artifact creation through built-in commands and status checks.

What is the best way to plan software changes without invoking multiple tools?

The best way to plan software changes without multiple tool invocations is using an automated end-to-end workflow. It scaffolds a complete change proposal with design and task artifacts in one step, ensuring fast and consistent planning.