kiro-spec-status

Parse spec metadata and markdown task lists to report phase progress.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/notta50/korenani --skill kiro-spec-status-notta50
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-status
Source: https://github.com/notta50/korenani/tree/main/.claude/skills/kiro-spec-status
Command: npx skills add https://github.com/notta50/korenani --skill kiro-spec-status-notta50

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide clear, scannable visibility into the current phase, completion status, and next actions for a specification stored in the repository, reducing uncertainty and surfacing blockers and revalidation risks.

Core Features & Use Cases

  • Phase & Progress Analysis: Reads spec metadata to identify the current phase and computes completion percentages for requirements, design, and tasks.
  • Task & Approval Tracking: Counts completed versus open tasks from markdown task lists and surfaces approval status from spec.json.
  • Boundary & Dependency Context: Extracts boundary candidates, upstream/downstream context, and nearby spec touchpoints from brief.md, design.md, and roadmap entries to build a revalidation watchlist.
  • Error Handling & Discovery: Reports missing files, lists available specs when none or a wildcard is provided, and suggests next-phase actions.

Quick Start

Run the kiro-spec-status skill for the spec named feature-name to generate a progress and next-actions report for the spec located under .kiro/specs/feature-name.

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 of my spec files in a repository?

To check spec progress, aggregate spec.json, brief.md, requirements.md, design.md, and tasks.md from your .kiro/specs directory to compute phase completion percentages and task counts. This generates a scannable report showing current phase, open tasks, and next actions.

What is spec revalidation and when do I need to track it?

Spec revalidation tracking identifies boundary candidates and upstream/downstream context from brief.md, design.md, and roadmap entries to surface blockers. You need it when managing dependencies across multiple specs to ensure changes in one specification do not break another.

How do I count completed versus open tasks from markdown task lists?

Count completed versus open tasks by parsing markdown task lists within tasks.md files. The analysis reads checkbox syntax to tally finished items, compares them against total tasks, and surfaces the approval status stored in spec.json.

Can I list all available specs if I don't specify a directory name?

Yes, you can list available specs when none or a wildcard is provided. The discovery feature scans the .kiro/specs directory, reports any missing files for existing specs, and suggests next-phase actions for each found specification.

Does the spec status report support multiple languages?

Yes, spec status reports support multiple languages. The output report is generated in the language declared within the spec.json file, ensuring the multi-part progress analysis matches the language configured for that specific specification.

What happens if requirements.md or design.md is missing from my spec directory?

If requirements.md or design.md is missing, the analysis handles the error by reporting the missing files explicitly. It still aggregates available files to compute partial completion percentages and suggests next-phase actions to fill the gaps.