spectra-propose

Create Spectra change proposals with artifacts, validation, and CLI commands.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/ycs77/gh-aw-todo-app --skill spectra-propose-ycs77
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectra-propose
Source: https://github.com/ycs77/gh-aw-todo-app/tree/main/.claude/skills/spectra-propose
Command: npx skills add https://github.com/ycs77/gh-aw-todo-app --skill spectra-propose-ycs77

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the end-to-end creation of a Spectra change proposal and its required artifacts, removing manual coordination of CLI commands, spec scans, artifact generation, analysis, and validation so changes are consistently prepared for implementation.

Core Features & Use Cases

  • Derives a clear change name from a user argument, plan file, or conversation context and classifies the change as Feature, Bug Fix, or Refactor.
  • Scans existing specs for overlap, creates a change directory, writes a proposal from Spectra instructions, generates dependent artifacts in order, runs analyze-fix loops, and validates then parks or applies the change.
  • Use case: turn a short requirement like "add dark mode" into a fully-formed Spectra change with proposal, tasks, design artifacts, validation passes, and a parked change ready for implementation.

Quick Start

Invoke the skill by sending a requirement message such as /spectra-propose add dark mode

Frequently Asked Questions about spectra-propose

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

FAQPage Schema
How do I generate a complete change proposal from a short requirement description?

To generate a complete change proposal, provide a requirement description and the skill derives a change name, classifies it as Feature or Bug Fix, scans specs, writes the proposal, and creates dependent artifacts. It then runs validation checks and parks the change for implementation.

What is the best way to automate Spectra artifact generation and spec scanning?

Automating Spectra artifact generation and spec scanning is handled by parsing conversation context or plan files to fetch artifact instructions, creating a change directory, and generating required artifacts in sequential order with automated analyze-fix loops.

Do I need the spectra CLI installed to create and validate change proposals?

Yes, you need the spectra CLI installed and available in your system PATH to create and validate change proposals. The skill relies on the CLI to execute spectra validate and spectra park commands during the workflow.

Can I use a plan file to draft a Spectra change proposal instead of typing requirements?

Yes, you can use a plan file to draft a Spectra change proposal instead of typing requirements. The skill supports plan-file extraction to automatically derive the change name and requirement context for proposal generation.

How does automated validation work for Spectra change proposals?

Automated validation for Spectra change proposals works by running analyze-fix iterations after artifact creation, executing the spectra validate command to ensure correctness, and optionally parking the validated change using the spectra park command.

What are the limitations of automating repository change workflows with Spectra?

Limitations of automating repository change workflows include a strict dependency on the spectra CLI being in PATH, requiring valid plan files or conversation context for extraction, and being confined to the Spectra proposal structure rather than generic repository commits.