openspec-propose

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

Updated Jan 5, 2025
One-click install
npx skills add https://github.com/ValorVie/settingZsh --skill openspec-propose-valorvie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/ValorVie/settingZsh/tree/main/.gemini/skills/openspec-propose
Command: npx skills add https://github.com/ValorVie/settingZsh --skill openspec-propose-valorvie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a structured change proposal with design documents, specifications, and implementation tasks requires coordinating multiple artifacts in the correct dependency order, which is tedious and error-prone when done manually. ## Core Features & Use Cases - One-Step Proposal Generation: Creates a change directory and generates all required artifacts (proposal.md, design.md, tasks.md) in a single workflow using the openspec CLI. - Dependency-Aware Artifact Creation: Reads the artifact build order from openspec status and generates each artifact only after its dependencies are complete. - Schema-Guided Output: Follows per-artifact instructions, templates, and rules from the openspec CLI so every file matches the expected structure. - Use Case: Describe a feature like "add user authentication" and receive a complete, implementation-ready change package under openspec/changes/add-user-auth/. ## Quick Start Ask the assistant to propose a new change by describing what you want to build, for example requesting a proposal for adding user authentication to your project.

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 proposal.md, design.md, and tasks.md in dependency order until the change is ready for implementation.

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?▼

Yes, the skill requires the openspec CLI to be installed. It uses commands like `openspec new change`, `openspec status`, and `openspec instructions` to scaffold changes and retrieve artifact templates.

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 failing silently.

How do I implement the change after the proposal is created?▼

Once all required artifacts are marked done, run `/opsx:apply` or ask the assistant to implement, which starts executing the tasks defined in tasks.md.