openspec-propose

Scaffold a change directory and generate proposal, design, and task artifacts.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/agoodway/goodissues_reporter --skill openspec-propose-agoodway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/agoodway/goodissues_reporter/tree/main/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/agoodway/goodissues_reporter --skill openspec-propose-agoodway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It streamlines proposing a change by producing the complete set of required artifacts (proposal, design, and implementation tasks) without you manually orchestrating each generation step.

Core Features & Use Cases

  • Change proposal scaffolding: Creates a new change directory from a clear change name or description so artifacts can be generated consistently.
  • One-step artifact generation: Builds required artifacts in dependency order until the proposal is apply-ready.
  • Interactive clarification: Asks follow-up questions when artifact context is unclear, then resumes generation to keep momentum.
  • Use case: When you want to quickly turn an idea into an implementation-ready plan for a software change, this guides you through producing all supporting documents and tasks.

Quick Start

Ask it: “Add support for background job retries with exponential backoff and make sure tasks are documented and implementation steps are clear.”

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I generate implementation tasks and design docs for a software change proposal?

To generate implementation tasks and design docs, you can scaffold a change directory and produce proposal, design, and task artifacts in dependency order. This creates a complete set of implementation-ready documentation from a single change description.

What is the best way to automate scaffolding a change directory for developer tooling?

Automating scaffolding for developer tooling involves using a CLI to create a change directory, compute artifact build order, and fetch artifact-specific instructions. This automatically structures your proposal, design, and task files consistently.

Can I use openspec to turn an idea into an implementation-ready plan without manual orchestration?

Yes, you can use openspec to turn an idea into an implementation-ready plan without manual orchestration. It builds required artifacts in dependency order until the proposal is apply-ready, stopping automatically once all outputs are written.

How does artifact generation handle unclear context when creating spec and design documents?

When artifact context is unclear during generation, the workflow uses interactive clarification by asking follow-up questions. After you provide answers, it resumes the generation process to maintain momentum and ensure accurate spec and design outputs.

Does workflow automation for change proposals work for process changes or only product engineering?

Workflow automation for change proposals works for product, engineering, and process changes. It is applicable to any scenario where a complete set of implementation-ready documentation artifacts is needed to propose a structured change.