kiro-spec-status

Compute phase completion and surface blockers from spec files.

Updated Feb 25, 2024
One-click install
npx skills add https://github.com/ryowatanabe/iidx-dp-unofficial-difficulty-scraper --skill kiro-spec-status-ryowatanabe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-status
Source: https://github.com/ryowatanabe/iidx-dp-unofficial-difficulty-scraper/tree/main/.claude/skills/kiro-spec-status
Command: npx skills add https://github.com/ryowatanabe/iidx-dp-unofficial-difficulty-scraper --skill kiro-spec-status-ryowatanabe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides clear visibility into specification progress and readiness, helping teams track phase status and identify blockers early.

Core Features & Use Cases

  • Load spec context from .kiro/specs/$ARGUMENTS/spec.json and related files (brief.md, requirements.md, design.md, tasks.md)
  • Parse each phase (Requirements, Design, Tasks, Approvals) to compute completion and highlight boundaries
  • Generate a concise status report including boundary context, upstream/downstream touchpoints, and a revalidation watchlist
  • Surface next actions and blockers to guide planning and decision making

Quick Start

Inspect the current spec status for a target spec to surface phase progress, blockers, and next actions.

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 progress and status of a spec stored in .kiro/specs?

To check spec status, the skill reads spec.json, brief.md, requirements.md, design.md, tasks.md, and roadmap.md from the .kiro/specs directory to compute phase completion and surface blockers. It generates a concise report showing current progress and actionable next steps.

What is the best way to identify blockers and boundaries in a product specification?

Identifying spec blockers involves parsing each phase like Requirements, Design, Tasks, and Approvals to compute completion and highlight boundaries. The skill surfaces upstream and downstream touchpoints alongside a revalidation watchlist to guide planning and decision making.

How does computing spec phase completion work with requirements and design files?

Computing spec phase completion works by reading requirements.md, design.md, and tasks.md alongside spec.json to evaluate each phase individually. It calculates readiness for Requirements, Design, Tasks, and Approvals phases to produce a status report with boundary context and next actions.

Can I use this to track roadmap progress for specs without additional project management tools?

Yes, you can track roadmap progress by reading the roadmap.md file within your spec directory structure. The skill computes phase completion and generates a revalidation watchlist to provide status discovery without needing external project management integrations.

When do I need to trigger spec revalidation during product development?

Spec revalidation is needed when boundaries shift or upstream and downstream touchpoints change during development. The skill generates a revalidation watchlist by analyzing spec.json and related files to surface exactly when and where revalidation should occur.

Why does my spec status report show incomplete phases even though tasks.md is finished?

Your spec status report may show incomplete phases because the skill evaluates Requirements, Design, Tasks, and Approvals separately by reading brief.md, design.md, and requirements.md. Completing tasks.md alone does not fulfill the other phase requirements needed for full completion.