openspec-propose

Generate proposal, design, and tasks artifacts via the openspec CLI.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/johnqxu/skills --skill openspec-propose-johnqxu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/johnqxu/skills/tree/main/dot_eprint_skills/.claude/skills/openspec-propose
Command: npx skills add https://github.com/johnqxu/skills --skill openspec-propose-johnqxu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose a new change and generate all relevant artifacts in a single action, saving time and aligning stakeholders with design, specs, and tasks.

Core Features & Use Cases

  • Single-command change proposal: create a change and generate artifacts (proposal.md, design.md, tasks.md)
  • Guided workflow: prompts for input and dependency resolution
  • Use Case: Imagine you want to standardize a change proposal process across teams

Quick Start

Describe what you want to build to generate a complete proposal with design, specs, and implementation tasks.

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 change proposal and related artifacts in one step?

You can generate a change proposal and related artifacts in one step by providing a high-level description or change name. The workflow derives a kebab-case identifier and scaffolds proposal.md, design.md, and tasks.md automatically in dependency order.

What is included when I scaffold a new change proposal for project planning?

Scaffolding a new change proposal generates three core artifacts: proposal.md, design.md, and tasks.md. This ensures all required project-planning artifacts are created together to align stakeholders with specs and implementation tasks.

Do I need the openspec CLI to automate proposal and task generation?

Yes, the openspec CLI is required to automate proposal and task generation. The process relies on the openspec CLI to scaffold changes, generate artifacts, and track status throughout the workflow.

Can I standardize change management workflows across teams with automated artifact generation?

You can standardize change management workflows across teams by using a single-command proposal process. Providing a quick high-level input auto-generates consistent design specs and tasks, ensuring uniform artifact creation.

What is the best way to track status after generating a change proposal?

The best way to track status after generating a change proposal is through the openspec CLI. It manages the guided workflow, scaffolds the initial artifacts, and tracks the change status throughout its lifecycle.

How does the workflow resolve dependencies when generating project-planning artifacts?

The workflow resolves dependencies by prompting for input and creating required artifacts in strict dependency order. This ensures the proposal, design, and tasks files are generated sequentially based on their relationships.