skills.rest
godot-go
godot-goOFFICIAL
Explore all skills by this author →
GitHub

openspec-propose

Generates complete OpenSpec change proposals with specs, design, and tasks artifacts.

747|30|Updated Jul 28, 2020
Search Tags:#planning#spec-driven#cli#design docs#tasks#OpenSpec#change proposal
One-click install
npx skills add https://github.com/godot-go/godot-go --skill openspec-propose-godot-go
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/godot-go/godot-go/tree/main/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/godot-go/godot-go --skill openspec-propose-godot-go

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, reviewable change proposal requires writing proposals, specs, design docs, and task lists by hand. This Skill automates that entire planning phase through the OpenSpec CLI, producing all required artifacts in one guided workflow. ## Core Features & Use Cases - One-Step Proposal Generation: Creates a change directory and generates proposal.md, specs, design.md, and tasks.md in dependency order using the openspec CLI. - Schema and Store Awareness: Supports custom workflow schemas and registered OpenSpec stores, with automatic project root detection and context loading from config.yaml. - Planning Boundary Enforcement: Produces planning artifacts only and explicitly stops before implementation, keeping proposal and apply phases separate. - Use Case: Describe "add user authentication" and receive a complete, validated change folder with delta specs, design decisions, and implementation tasks ready for review before any code is written. ## Quick Start Ask the assistant to run openspec propose to create a change named add-user-auth with a full proposal, specs, design, 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 create an OpenSpec change proposal?▼

Describe what you want to build or provide a kebab-case change name, and the workflow runs openspec new change, then generates each required artifact in dependency order using openspec instructions and status commands.

What artifacts does an OpenSpec proposal include?▼

With the default spec-driven schema it creates proposal.md, specs/<capability>/spec.md delta files, design.md, and tasks.md. The exact set is determined by the schema and the transitive requires edges reported by openspec status.

Does openspec propose require an initialized project?▼

Yes, it expects a project with an openspec root or a registered store. If no root exists and you explicitly requested OpenSpec, it asks whether to run openspec init, target a store, or continue without OpenSpec.

Can openspec propose implement the change automatically?▼

No, the workflow is strictly planning-only. After artifacts are complete it stops and waits for a new request; implementation happens through the separate apply workflow such as /openspec-apply-change.

How do I use a custom schema or store with openspec propose?▼

Request a schema by name to add --schema <schema-name>, or name a registered store so the workflow discovers it with openspec store list --json and appends --store <id> to subsequent commands.

Related Skills

Explore More Software Engineering Skills→
74th74th

openspec-propose

Generates complete OpenSpec change proposals with specs, design, and tasks artifacts.

Community
Advanced
capella-hotel-groupcapella-hotel-group

openspec-bulk-archive-change

Archives multiple completed OpenSpec changes in one batch with spec conflict resolution.

Official
Advanced
WizarckWizarck
2

bmad-code-review

Reviews code changes adversarially using parallel review layers with structured triage into actionable categories.

Community
Advanced
chohra-medchohra-med
28

spec-harness-tickets

Convert ticket tracker issues and ad-hoc plans into structured spec documents.

Community
Advanced