Can I resume a debugging session if I get interrupted?

Yes, the skill automatically checks for active sessions in your project and allows you to resume any ongoing investigation with its full persistent state.

Does Kata Debug automatically change my code?

The skill focuses on finding the root cause first. Once the cause is confirmed, it provides options to apply an automated fix, plan a fix, or handle it manually.

How does Kata Debug save context during long investigations?

It spawns isolated subagents for the heavy lifting of reading files and testing, while logging progress to a .planning/debug directory to keep the main chat history clean.

Which models does this skill use for debugging?

It uses a model profile system (quality, balanced, or budget) to select the best model for the task, typically defaulting to Claude 3.5 Sonnet or Opus for high-accuracy investigations.

Kata Debug

Name: Kata Debug
Author: gannonh

bygannonh

•

開発者ツール

Systematically investigates and resolves software bugs using scientific method-based subagent isolation.

Kata Debug is a specialized workflow for Claude Code designed to tackle complex technical issues without exhausting the main conversation's context window. By spawning isolated subagents specifically for investigation, it follows a rigorous process of gathering symptoms, forming hypotheses, and conducting tests while maintaining persistent state in a local directory. This approach allows developers to manage deep-seated errors that require extensive file reading and state tracking, providing a clear root-cause analysis and structured checkpoints before any code changes are implemented.

主な機能

01Persistent session state for long-running investigations

02Scientific method-based debugging and hypothesis testing

03Structured symptom gathering (expected vs. actual behavior)

041 GitHub stars

05Subagent isolation to preserve main conversation context

06Checkpoint system for user feedback during complex tasks

ユースケース

01Tracking down intermittent bugs that require deep file analysis

02Systematic root cause analysis without losing conversation history

03Troubleshooting complex logic errors in large codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gannonh/kata-marketplace kata-debug

For use in Claude.ai and ChatGPT

Download Skill