openspec-propose

Generates complete change proposals with design, specs, and tasks via the openspec CLI.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/yujikawa/modscape --skill openspec-propose-yujikawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/yujikawa/modscape/tree/main/.gemini/skills/openspec-propose
Command: npx skills add https://github.com/yujikawa/modscape --skill openspec-propose-yujikawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, implementation-ready change proposal normally requires manually writing proposal documents, design notes, and task lists. This Skill automates that entire flow in one step using the openspec CLI. ## Core Features & Use Cases - One-Step Proposal Generation: Creates a change directory and generates proposal.md, design.md, and tasks.md artifacts in dependency order. - Schema-Driven Artifacts: Reads openspec instructions and templates for each artifact so output follows the project's specification structure. - Dependency-Aware Sequencing: Checks artifact status via openspec status and builds artifacts only when their dependencies are complete. - Use Case: Describe "add user authentication" and receive a scaffolded change at openspec/changes/add-user-auth/ with a full proposal, design, and task list ready for implementation. ## Quick Start Ask the assistant to propose a new change for the feature you want to build, for example by describing the feature and letting it derive a kebab-case change name.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I create a change proposal with openspec?▼

Describe what you want to build and the Skill derives a kebab-case name, runs openspec new change, then generates proposal.md, design.md, and tasks.md in dependency order using openspec instructions.

What artifacts does an openspec change proposal include?▼

A proposal typically includes proposal.md covering what and why, design.md covering how, and tasks.md listing implementation steps. The exact set is determined by the schema's applyRequires field reported by openspec status.

Does openspec-propose require any external tools?▼

Yes, it requires the openspec CLI to be installed. The Skill shells out to commands like openspec new, openspec status, and openspec instructions to scaffold changes and fetch artifact templates.

What happens if a change with the same name already exists?▼

The Skill asks whether you want to continue the existing change or create a new one with a different name, rather than overwriting or failing silently.

When should I not use the one-step propose flow?▼

Avoid it when requirements are still highly ambiguous and need stakeholder discussion first, or when your project does not use openspec for spec-driven change management, since the artifacts follow openspec schemas.