openspec-propose

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

1|Updated Jun 30, 2026
One-click install
npx skills add https://github.com/trutoman/Conjuros --skill openspec-propose-trutoman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/trutoman/Conjuros/tree/main/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/trutoman/Conjuros --skill openspec-propose-trutoman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a full change proposal by hand means creating proposal, spec, design, and task documents separately and keeping them consistent. This Skill automates that by driving the OpenSpec CLI to scaffold a change and generate every required artifact in one guided pass. ## Core Features & Use Cases - One-step change creation: Runs openspec new change and then generates all artifacts the apply phase transitively depends on, including proposal.md, specs, design.md, and tasks.md. - Dependency-aware artifact ordering: Parses openspec status --json to resolve artifact dependency edges and creates artifacts in the correct order, re-reading dependencies from disk for context. - Store and schema awareness: Supports registered OpenSpec stores via --store <id> and respects schema rules such as skip_specs and conditional artifacts like design.md. - Use Case: Describe "add user authentication" and receive a complete add-user-auth change with proposal, capability spec deltas, design notes, and an implementation task list ready for /opsx-apply. ## Quick Start Ask the assistant to propose a new change by describing what you want to build, for example: propose a change to add user authentication to the app.

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. It finishes by showing `openspec status` so you can confirm the change is ready for implementation.

What artifacts does an OpenSpec proposal include?

With the default spec-driven schema it creates proposal.md, spec deltas under specs/<capability>/spec.md, design.md, and tasks.md. The exact set is determined by the apply phase's transitive dependency closure, not just the apply.requires list.

Does openspec-propose work with registered OpenSpec stores?

Yes. If you name a store, it runs `openspec store list --json` to discover store ids and passes `--store <id>` to commands that read or write specs and changes. Without a store, commands act on the nearest local openspec/ root.

Why is design.md sometimes skipped in a change proposal?

design.md is a conditional artifact in the spec-driven schema, so it is skipped when its instruction marks it optional. Artifacts reporting status skipped due to skip_specs in .openspec.yaml must never be created.

What are the requirements for using openspec-propose?

You need the openspec CLI installed and available in the environment, since the skill only invokes openspec commands. You should also provide either a kebab-case change name or a description of what you want to build.