skills.rest
zooroy
zooroyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

spectra-apply

Apply Spectra changes by generating instructions, running preflight checks, and tracking tasks via markdown checkboxes.

Updated Apr 27, 2026
Search Tags:#tdd#workflow automation#cli#task tracking#spectra#artifact consistency#apply changes
One-click install
npx skills add https://github.com/zooroy/appt-system --skill spectra-apply-zooroy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spectra-apply
Source: https://github.com/zooroy/appt-system/tree/main/.agents/skills/spectra-apply
Command: npx skills add https://github.com/zooroy/appt-system --skill spectra-apply-zooroy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires spectra.

What problem does it solve?

This Skill helps you implement or resume a change described by Spectra without losing progress or breaking consistency across artifacts and tasks.

Core Features & Use Cases

  • Change selection and safety checks: Selects an active Spectra change (or asks when ambiguous), detects parked changes, and handles unpark/in-progress states.
  • Spec-driven execution with guardrails: Fetches apply instructions, checks preflight status (clean/warnings/critical), and runs artifact analysis to catch cross-artifact issues before coding.
  • File-based task progress tracking: Uses only the tasks file markdown checkboxes as the single source of truth, avoiding external trackers.
  • TDD and audit modes support: Reads project preferences from .spectra.yaml and follows TDD and audit discipline when enabled, including structured Red-Green-Refactor guidance.

Quick Start

Run spectra-apply with no arguments to infer the correct active change from context and continue implementing it.

Frequently Asked Questions about spectra-apply

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

FAQPage Schema
How do I apply code changes from a spec while tracking task progress in markdown?▼

To apply spec changes safely, this Skill fetches implementation instructions and executes tasks while tracking progress exclusively via markdown checkboxes in the tasks file, ensuring no progress is lost. It updates the official tasks file state as the single source of truth.

Can I resume a partially completed workflow if some implementation tasks are already done?▼

Yes, you can resume partially completed changes. The workflow detects in-progress states and reads existing markdown task checkboxes to continue execution from where you left off, handling parked or unparked changes automatically with user confirmation when needed.

How do preflight and artifact consistency checks work before executing implementation tasks?▼

Preflight and artifact consistency checks run before coding by analyzing the preflight status for clean, warnings, or critical states and catching cross-artifact issues. The workflow reacts to blocked, all_done, warnings, and critical outcomes, prompting user confirmation before proceeding.

Do I need the spectra CLI to run TDD workflows with Red-Green-Refactor discipline?▼

Yes, the spectra CLI is required. When TDD mode is enabled in .spectra.yaml, the workflow reads project preferences and follows structured Red-Green-Refactor guidance alongside audit discipline during the implementation phase.

What's the best way to handle blocked or critical preflight states during task execution?▼

When preflight analysis returns blocked, warnings, or critical states, the workflow pauses execution and prompts for user confirmation. This guardrail ensures artifact consistency is verified before any remaining implementation tasks are applied to the codebase.

Related Skills

Explore More Software Engineering Skills→
howiehowie

spectra-apply

Apply Spectra change tasks to a codebase using Spectra CLI JSON output.

Community
Advanced
fhsh-tpfhsh-tp

spectra-archive

Verify artifact and task completion, sync delta specs, and archive changes via spectra CLI.

Official
Intermediate
synaptiaisynaptiai
6

tdd-patterns

Track RED-GREEN-REFACTOR tasks for TDD cycles in CI workflows.

Official
Intermediate
SHUSHU010829SHUSHU010829

spectra-apply

Automate task implementation and resumption within Spectra changes via the spectra CLI.

Community
Advanced