When does this skill activate?

The skill is triggered whenever Claude is about to fix an error, modify an implementation, or address a bug report.

How does it improve code quality?

By forcing a review of design docs and execution flows, it ensures that fixes are minimal and don't introduce new bugs or technical debt.

Does it provide documentation of the investigation?

Yes, for complex problems, it encourages creating Mermaid diagrams and structured logs in a temporary investigation directory to visualize the root cause.

What does the fix-checklist skill do?

It provides a standardized protocol that Claude must follow before fixing code, focusing on finding the root cause rather than just patching the immediate symptom.

Root Cause Analysis & Fix Checklist

Name: Root Cause Analysis & Fix Checklist
Author: tettuan

bytettuan

0•

生産性とワークフロー

Enforces a systematic root-cause analysis workflow to prevent symptom-driven code fixes and technical debt.

The fix-checklist skill optimizes Claude's debugging process by mandating a thorough investigation before any code is modified. Instead of applying superficial patches to error symptoms, this skill guides Claude through a structured protocol: questioning the error's origin, reviewing design documentation, and tracing execution flows. By identifying the true root cause—which often resides far from the point of failure—it ensures that modifications are minimal, accurate, and aligned with the original system architecture.

主な機能

010 GitHub stars

02Prevents immediate 'symptom-driven' patching by requiring a 'why' analysis.

03Mandates design document and schema reviews to understand intended behavior.

04Supports structured visual investigations using Mermaid diagrams for complex issues.

05Distinguishes between the error location and the actual root cause.

06Traces data flows from triggers to expected states to find points of divergence.

ユースケース

01Documenting the investigation process for large-scale architectural fixes.

02Debugging complex runtime errors where the crash site differs from the logic error.

03Ensuring code modifications align with existing system design and schema contracts.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tettuan/breakdownconfig fix-checklist

For use in Claude.ai and ChatGPT

Download Skill