openspec-propose

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

1|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/QlikL/pet-shop --skill openspec-propose-qlikl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/QlikL/pet-shop/tree/main/.trae/skills/openspec-propose
Command: npx skills add https://github.com/QlikL/pet-shop --skill openspec-propose-qlikl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a full change proposal with design documents, specifications, and implementation tasks is slow and inconsistent. This Skill turns a short description of what you want to build into a complete, structured proposal in one step. ## Core Features & Use Cases - One-Step Proposal Generation: Creates proposal.md, design.md, and tasks.md artifacts in dependency order using the openspec CLI. - Guided Artifact Workflow: Reads openspec status and instructions to build each artifact with the correct template and schema rules. - Use Case: Describe a feature like "add user authentication" and receive a scaffolded change directory with a ready-to-implement proposal, design, and task list. ## Quick Start Ask the assistant to propose a change for adding user authentication and it will generate the full proposal, 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 a change proposal with openspec?

Describe what you want to build or provide a kebab-case change name. The skill runs openspec new change to scaffold the directory, then generates proposal.md, design.md, and tasks.md in dependency order until the change is apply-ready.

What artifacts does an openspec 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 the openspec CLI installed?

Yes, the skill depends on the openspec command-line tool. It invokes commands like openspec new change, openspec status, and openspec instructions to scaffold and generate artifacts.

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 duplicating work.

How do I implement the proposal after it is generated?

Once all required artifacts are marked done, run /opsx:apply or ask the assistant to implement. The skill verifies each artifact file exists before moving to the next one.