openspec-propose

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

1|Updated Oct 27, 2025
One-click install
npx skills add https://github.com/WndDnz/modelo-relatorio-unifei-ict --skill openspec-propose-wnddnz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/WndDnz/modelo-relatorio-unifei-ict/tree/main/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/WndDnz/modelo-relatorio-unifei-ict --skill openspec-propose-wnddnz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, reviewable implementation plan requires writing proposals, spec deltas, design documents, 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 change scaffolding: Creates a kebab-case change directory and generates every artifact the apply phase depends on, including proposal.md, spec deltas, design.md, and tasks.md. - Dependency-aware artifact ordering: Queries openspec status --json to resolve artifact dependencies transitively and builds them in the correct order. - Schema and store support: Works with the configured default workflow schema, explicit --schema selections, and registered OpenSpec stores via --store flags. - Use Case: Describe "add user authentication" and receive a complete, validated planning package with proposal, spec deltas, design, and implementation tasks ready for review before any code is written. ## Quick Start Ask the assistant to propose a new change describing what you want to build, for example: create an OpenSpec proposal for adding user authentication.

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 and the skill derives a kebab-case change name, runs `openspec new change`, then generates every required artifact in dependency order. You review the artifacts before starting the apply workflow.

What artifacts does an OpenSpec proposal include?

With the default spec-driven schema it creates proposal.md, spec deltas under specs/<capability-path>/spec.md, design.md, and tasks.md. The exact set is determined by the schema and the transitive dependencies of the apply phase.

Does openspec-propose implement the change automatically?

No. The workflow is planning-only by design and never edits project code. After the artifacts are presented, you must explicitly start the apply workflow with a new request such as running /opsx-apply.

Can I use a custom schema or a registered OpenSpec store?

Yes. Pass a schema name explicitly to use `--schema`, or name a registered store and the skill discovers it with `openspec store list --json` and applies `--store <id>` to all subsequent commands.

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, rather than overwriting or duplicating work silently.