openspec-propose

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

Updated Aug 29, 2026
One-click install
npx skills add https://github.com/Joao-Camilo-Mallmann/ofurry-motion-graphics --skill openspec-propose-joao-camilo-mallmann
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/Joao-Camilo-Mallmann/ofurry-motion-graphics/tree/main/.agents/skills/openspec-propose
Command: npx skills add https://github.com/Joao-Camilo-Mallmann/ofurry-motion-graphics --skill openspec-propose-joao-camilo-mallmann

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, implementation-ready change proposal normally requires manually writing design docs, specs, and task lists. This Skill automates that entire process through the OpenSpec CLI, producing all required artifacts in one guided workflow. ## Core Features & Use Cases - One-Step Proposal Generation: Creates a change scaffold and generates proposal.md, design.md, and tasks.md artifacts in dependency order. - Schema-Driven Artifacts: Follows OpenSpec instructions, templates, and dependency rules so every artifact conforms to the project's spec schema. - Multi-Store Support: Discovers registered OpenSpec stores and targets the correct one with the --store flag. - Use Case: Describe a feature like "add user authentication" and receive a validated change directory with a proposal, technical design, and ordered implementation tasks ready to execute. ## Quick Start Ask the assistant to propose a new change for the feature you want to build, for example: propose a change to add 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?

Provide a kebab-case change name or describe what you want to build. The Skill runs openspec new change, then generates each required artifact (proposal, design, tasks) in dependency order using openspec instructions until the change is apply-ready.

What artifacts does an OpenSpec proposal include?

A typical proposal 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 work with multiple OpenSpec stores?

Yes. It runs openspec store list --json to discover registered stores and passes --store <id> to commands that read or write specs and changes. Without a store, commands act on the nearest local openspec/ root.

What happens after the proposal artifacts are created?

Once all applyRequires artifacts show status done, the change is ready for implementation. You then run /opsx:apply or ask the assistant to implement the tasks defined in tasks.md.

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