kata-doctor

Diagnose and repair Kata project roadmap formatting and phase-directory integrity.

2|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/gannonh/kata-skills --skill kata-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-doctor
Source: https://github.com/gannonh/kata-skills/tree/main/skills/kata-doctor
Command: npx skills add https://github.com/gannonh/kata-skills --skill kata-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Kata projects often drift when roadmaps and phase planning documents become stale or inconsistent. kata-doctor provides automated health checks to verify project structure and helps migrate legacy ROADMAP.md formats to the canonical current format, reducing manual cleanup.

Core Features & Use Cases

  • Health checks for roadmap format compliance and phase-directory consistency.
  • Migration guidance to convert old ROADMAP.md into the canonical current format and fix phase collisions.
  • Interactive prompts for dangerous actions, with non-destructive reporting when auto mode is enabled.

Quick Start

Run kata-doctor to perform a health check on your project and migrate ROADMAP.md to the canonical format when needed.

Frequently Asked Questions about kata-doctor

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

FAQPage Schema
How do I migrate a stale ROADMAP.md to the canonical format in a Kata project?

To migrate a stale ROADMAP.md, run an automated health check to enforce format migration rules and convert legacy structures into the canonical current format, reducing manual cleanup and verifying project structure consistency.

What are project maintenance health checks for phase-directory integrity?

Project maintenance health checks diagnose and repair issues by verifying phase-directory integrity, detecting collisions, and performing a two-pass directory rename when needed to maintain a consistent project structure.

How do I detect and fix phase collisions during project initialization?

To detect and fix phase collisions during project initialization, apply automated health checks that flag collisions and execute a two-pass phase directory rename to resolve naming conflicts and restore directory integrity.

Can I automate project maintenance tasks without interactive prompts?

Yes, you can automate project maintenance tasks using auto-mode behavior, which provides non-destructive reporting and bypasses interactive prompts for dangerous actions, safely applying format migrations and collision fixes.

When do I need to run a roadmap format migration?

You need to run a roadmap format migration when a stale ROADMAP.md is detected, during regular maintenance cycles, or upon project initialization to enforce compliance with the canonical current format and fix phase inconsistencies.