openspec-propose

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

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/DagimAlemayehuu/AgenticEngineering --skill openspec-propose-dagimalemayehuu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/DagimAlemayehuu/AgenticEngineering/tree/main/agentic-engineering/core/dependencies/openspec/openspec-propose
Command: npx skills add https://github.com/DagimAlemayehuu/AgenticEngineering --skill openspec-propose-dagimalemayehuu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, implementation-ready change proposal normally requires manually writing proposals, design documents, and task lists. This Skill automates that entire flow through the OpenSpec CLI, producing all required artifacts in one guided step. ## Core Features & Use Cases - One-Step Change Creation: Runs openspec new change and generates proposal.md, design.md, and tasks.md artifacts in dependency order. - Schema-Driven Artifacts: Fetches per-artifact instructions, templates, and rules from openspec instructions so every file follows the project's specification schema. - Dependency-Aware Sequencing: Reads openspec status JSON to determine which artifacts are ready, reads completed dependencies for context, and stops only when all apply-required artifacts are done. - Use Case: Describe "add user authentication" and receive a scaffolded change at openspec/changes/add-user-auth/ with a complete proposal, design, and task breakdown ready for implementation via /opsx:apply. ## Quick Start Ask the assistant to use the openspec-propose skill to create a change proposal for the feature you want to build, describing it in a sentence.

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 from a feature idea?▼

Provide a description of 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 apply-ready.

What artifacts does an OpenSpec proposal include?▼

A typical change includes proposal.md describing 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 CLI for creating changes, reading status JSON, and fetching artifact instructions. Without the CLI available in the environment, the workflow cannot execute its 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 with a different name, rather than overwriting or duplicating the existing change directory.

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

Once all apply-required artifacts show done status, run /opsx:apply or ask the assistant to implement. The generated tasks.md provides the ordered implementation steps for the change.