openspec-propose

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

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/74th/test-llm-agent --skill openspec-propose-74th
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/74th/test-llm-agent/tree/main/20260922-openai-agentapi-selfhosted-sandbox/.agents/skills/openspec-propose
Command: npx skills add https://github.com/74th/test-llm-agent --skill openspec-propose-74th

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, implementation-ready plan requires writing proposals, specs, design docs, 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 Change Proposals: Creates a new OpenSpec change and generates every required artifact (proposal.md, specs, design.md, tasks.md) in dependency order. - Schema-Aware Planning: Follows the project's configured workflow schema, reads artifact instructions from the OpenSpec CLI, and respects conditional or skipped artifacts. - Store and Project Context Handling: Discovers registered OpenSpec stores, loads project context from config.yaml, and safely handles uninitialized projects without creating roots as a side effect. - Use Case: Describe "add user authentication" and receive a complete change folder containing a proposal, capability spec deltas, a design document, and an implementation task list ready for review. ## Quick Start Ask the assistant to run openspec propose to create a change named add-user-auth with a full proposal, specs, 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 an OpenSpec change proposal?▼

Provide a kebab-case change name or a description of what you want to build, then run the propose workflow. It creates the change with openspec new change and generates proposal, specs, design, and tasks artifacts in dependency order.

What artifacts does openspec propose generate?▼

With the default spec-driven schema it generates proposal.md, spec deltas under specs/<capability-path>/spec.md, design.md, and tasks.md. The exact set is determined by the schema and the transitive requires edges reported by openspec status.

Does openspec propose implement the code after planning?▼

No. The workflow is strictly planning-only and stops after presenting the artifacts. Implementation requires a separate explicit request that starts the apply workflow, such as openspec-apply-change.

What happens if my project is not initialized with OpenSpec?▼

The skill checks for an OpenSpec root before writing anything. If none exists and you explicitly requested OpenSpec, it asks whether to run openspec init, target a registered store, or continue without OpenSpec, and never creates the root automatically.

Can I use openspec propose with a registered store?▼

Yes. Run openspec store list --json to discover store ids, then the skill appends --store <id> to all commands that read or write specs and changes, treating it as sticky for the rest of the workflow.