openspec-propose

Generate OpenSpec proposal, design, and task artifacts for implementation.

5|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/Catsofsuffering/CCGS --skill openspec-propose-catsofsuffering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/Catsofsuffering/CCGS/tree/main/.codex/skills/openspec-propose
Command: npx skills add https://github.com/Catsofsuffering/CCGS --skill openspec-propose-catsofsuffering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines the creation of OpenSpec changes by automatically scaffolding a change and generating the required proposal, design, and task artifacts so users avoid manual setup and coordination before implementation.

Core Features & Use Cases

  • One-step proposal generation: Creates a change scaffold and populates proposal.md, design.md, and tasks.md so work can move to implementation faster.
  • Dependency-aware artifact creation: Queries openspec status and instructions to generate artifacts in dependency order and verifies apply readiness.
  • Interactive clarification and tracking: Uses user questions to clarify unclear inputs and a todo/tracking mechanism to show progress and created artifacts.
  • Use Case: Quickly produce a complete design and task breakdown for a feature request, bug fix, or specification change that is ready to hand off to engineering teams.

Quick Start

Propose a new change to add user authentication and generate all proposal, design, and task artifacts 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 complete change proposal for OpenSpec in one step?

To generate an OpenSpec change proposal in one step, this Skill automatically scaffolds the change directory and populates proposal.md, design.md, and tasks.md artifacts. This streamlines change creation by avoiding manual setup and coordination before implementation.

What artifacts are required for an OpenSpec change before implementation?

An OpenSpec change requires proposal.md, design.md, and tasks.md artifacts before implementation. This Skill generates these required files automatically by querying openspec status and instructions to create them in dependency order and verify apply readiness.

Do I need the openspec CLI installed to create change proposals?

Yes, creating OpenSpec change proposals requires the openspec CLI installed and permission to run openspec status and openspec instructions commands, plus read and write file access in the change directory to generate the required artifacts.

How does dependency-aware artifact generation work for OpenSpec proposals?

Dependency-aware artifact generation queries openspec status and instructions to produce proposal, design, and task artifacts in the correct dependency order. This ensures the change scaffold is populated sequentially and verifies apply readiness before implementation begins.

Can I track progress when generating OpenSpec change artifacts?

Yes, you can track progress during OpenSpec artifact generation through a built-in todo and tracking mechanism that displays creation progress and lists generated artifacts. The Skill also uses interactive questions to clarify unclear inputs during the workflow.

What is the best way to scaffold an OpenSpec change for a feature request?

The best way to scaffold an OpenSpec change for a feature request is to use automated one-step proposal generation, which creates the change scaffold and populates all required proposal, design, and task artifacts ready for engineering handoff.