openspec-propose

Convert a user-described software change into proposal, design, and implementation task artifacts.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/Andresch2/Workflows --skill openspec-propose-andresch2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/Andresch2/Workflows/tree/main/.github/skills/openspec-propose
Command: npx skills add https://github.com/Andresch2/Workflows --skill openspec-propose-andresch2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly turn a vague idea or change request into a complete, implementation-ready proposal package, avoiding the overhead of manually drafting separate design, specs, and task plans.

Core Features & Use Cases

  • One-step proposal generation: Creates the core artifacts (proposal.md, design.md, tasks.md) together so you can move forward faster.
  • Structured change scaffolding: Initializes a new change using the provided change name (kebab-case) or derived name from your description.
  • Apply-ready workflow: Produces artifacts up to the point where the change can be implemented via /opsx:apply, after showing final status.

Quick Start

Describe what you want to build or fix, and I will create the full proposal package with design, specs, and tasks ready for implementation.

Frequently Asked Questions about openspec-propose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a design spec and task plan from a software change description?

Generating a design spec and task plan from a software change description is done by converting the input into a complete proposal package, automatically scaffolding the proposal.md, design.md, and tasks.md artifacts together in dependency order.

What is a proposal package for software change management?

A proposal package for software change management is a structured set of artifacts including proposal, design, and implementation tasks that scaffolds a change request into an apply-ready workflow, avoiding the overhead of manually drafting separate files.

How do I scaffold implementation tasks in dependency order using GitHub workflows?

Scaffolding implementation tasks in dependency order involves running a new change initialization, checking status to determine apply requirements, and generating artifacts via templated instructions until apply-ready files are finished.

Can I use openspec to generate a complete proposal without manually writing separate specs?

Yes, you can use openspec to generate a complete proposal without manually writing separate specs by providing a description of what you want to build or fix, which scaffolds the full change package in one step.

Does proposal generation stop automatically once the change artifacts are apply-ready?

Yes, proposal generation stops automatically once apply-ready artifacts are finished, after determining artifact dependencies and showing the final status to ensure the change is ready for implementation.