openspec-propose

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, reviewable change proposal 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 Proposal Generation: Creates a change directory and generates every required artifact (proposal.md, spec deltas, design.md, tasks.md) in dependency order. - Schema-Aware Planning: Respects the configured OpenSpec workflow schema, supports registered stores, and follows each artifact's authoritative instructions and templates. - Dependency Tracking: Uses openspec status and openspec instructions to determine the transitive set of artifacts needed before implementation, skipping conditional or skipped artifacts correctly. - Use Case: Describe "add user authentication" and receive a complete, validated planning package ready for review, without touching any project code. ## Quick Start Ask the assistant to propose a new change, for example: "Propose a change called add-user-auth that adds login with email and password."

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?

Provide a kebab-case change name or describe what you want to build. The skill runs `openspec new change`, then generates every required artifact (proposal, specs, design, tasks) in dependency order using `openspec status` and `openspec instructions`.

What artifacts does an OpenSpec proposal include?

With the default spec-driven schema it creates proposal.md (what and why), spec deltas under specs/<capability-path>/spec.md, design.md (how), and tasks.md (implementation steps). The exact set depends on the configured schema and its dependency graph.

Does openspec-propose implement the change after planning?

No. The workflow is planning-only by design. After artifacts are complete it stops and waits for a new user request; implementation happens through the separate apply workflow, such as running /opsx-apply.

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

Yes. Explicitly request a schema by name to pass `--schema`, or name a registered store so the skill discovers it with `openspec store list --json` and appends `--store <id>` to all scoped 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.