openspec-propose

Generate OpenSpec change proposal packages with proposal, design, and task artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose a new change and automatically generate all necessary OpenSpec artifacts (proposal.md, design.md, tasks.md) in one cohesive workflow, accelerating the planning phase.

Core Features & Use Cases

  • One-step proposal: Create a change scaffold with all artifacts ready for review and implementation.
  • Artifact sequencing: Respect dependencies and apply-ready checks to ensure coherent artifact generation.
  • Collaborative input: Accept either a kebab-case change name or a natural-language description to seed the proposal.

Quick Start

Ask the user for a kebab-case change name or a description of what to build, then generate a scaffolded change with all artifacts.

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 package with OpenSpec scaffolding?

OpenSpec scaffolding generates a complete change proposal package by creating proposal, design, and task artifacts in one step. You provide a kebab-case change name or natural-language description to seed the proposal files.

What is OpenSpec artifact generation and when do I need it for software planning?

OpenSpec artifact generation automates the creation of change, design, and task documents for software teams. You need it when starting a new feature or fix to accelerate the planning phase with ready-to-implement files.

Can I use a natural-language feature description to seed an OpenSpec proposal?

Yes, you can use a natural-language description to seed an OpenSpec proposal. The scaffolding process accepts either a kebab-case change name or a descriptive prompt to derive artifact IDs and generate the proposal package.

Does OpenSpec proposal generation enforce dependencies between change, design, and task artifacts?

OpenSpec proposal generation enforces artifact dependencies and applies ready-to-implement checks. This sequencing ensures coherent generation of proposal, design, and task files according to the instruction schema.

What is the best way to automate design doc creation for a new software feature?

Automating design doc creation is best handled by scaffolding all OpenSpec artifacts at once. This approach derives artifact IDs from the change name and produces proposal, design, and task files simultaneously.

What are the limitations of one-step OpenSpec proposal scaffolding?

One-step OpenSpec proposal scaffolding requires a kebab-case change name or description to derive artifact IDs. It respects dependency sequencing but produces files that still require team review before implementation begins.