kiro-spec-status

Reports specification progress, pending work, and the next workflow command for Kiro specs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/scapia-oss/compass --skill kiro-spec-status-scapia-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-status
Source: https://github.com/scapia-oss/compass/tree/main/tools/cc-sdd/templates/agents/claude-code-skills/skills/kiro-spec-status
Command: npx skills add https://github.com/scapia-oss/compass --skill kiro-spec-status-scapia-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? When working through a spec-driven development workflow, it is easy to lose track of which phase a feature is in, what remains unfinished, and which command to run next. This Skill reads the spec files under the .kiro directory and produces a clear status report so you always know where you stand. ## Core Features & Use Cases - Deterministic Status Snapshot: Runs a bundled status script that computes progress, task counts, active spec detection, and the exact next command. - Lifecycle-Aware Reporting: Reads spec.json configuration (spec type, workflow, artifact toggles, required gates) and shows a phase-by-phase journey with completed, in-progress, upcoming, and skipped states. - Multi-Repo Linkage: Detects satellite and peer linked specs, reporting parent repo pointers, branch parity, and downstream footprints across repositories. - Use Case: After returning to a project mid-implementation, ask for the status of your feature spec to see which tasks are done, which gates (design review, implementation validation, retrospective) are still required, and the exact next command to run. ## Quick Start Ask the assistant to show the status of a spec by saying: run kiro-spec-status for my-feature and tell me what to do next.

Frequently Asked Questions about kiro-spec-status

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

FAQPage Schema
How do I check the status of a Kiro spec?

Run the kiro-spec-status skill with the feature name as an argument, or with no argument to list all specs. It runs a bundled status script that prints the current phase, task counts, and the exact next command to execute.

How do I know what command to run next in a spec workflow?

The status report computes the next action from the lifecycle navigation rules based on which phases are approved in spec.json. If a required gate like design review or implementation validation is incomplete, it becomes the first next action.

Does kiro-spec-status work with specs in subdirectories like features or bugs?

Yes, it resolves spec paths across specs/features, specs/bugs, specs/tech-debt, specs/chores, and the legacy flat specs directory. It also flags misplaced specs whose directory does not match their spec_type and suggests migration.

What happens if the spec I ask about is not found?

The skill reports that no spec was found for the given name and lists the available spec directories under the .kiro specs folder so you can pick the correct one.

Can kiro-spec-status handle specs linked across multiple repositories?

Yes, it detects satellite and peer linked specs via spec-link.md. Satellites report their parent repo pointer and local change checklist, while peers show the normal phase journey plus sibling repo context.