What is the primary tool used by this skill?

The skill primarily utilizes debugsk, a local HTTP ingest logger, to capture decisive signals and instrumentation data without contaminating native production logs.

How does the hypothesis-driven workflow work?

It requires defining specific predictions and falsifiers for multiple competing theories, then using targeted instrumentation to prove or disprove them based on facts.

Will this skill leave debugging code in my repository?

No, the skill includes a strict cleanup policy that explicitly removes all investigation logs and instrumentation files once the user confirms the issue is resolved.

Can I use this skill for production-level incidents?

Yes, it is designed to handle local, staging, and production environments by pivoting between new instrumentation and existing telemetry like traces and config diffs.

Advanced Bug Investigation

Name: Advanced Bug Investigation
Author: abekdwight

byabekdwight

0•

安全与测试

Implements a hypothesis-driven workflow to isolate root causes and resolve complex software regressions with precision.

This skill provides Claude with a rigorous, scientific approach to debugging software issues, ranging from flaky tests to critical production incidents. By prioritizing fact-based observations over speculative fixes, it guides the AI through creating structured hypotheses, instrumenting code using the specialized debugsk local logger, and executing controlled reproductions. It is particularly effective for developers who need to narrow down root causes in complex systems without polluting native logs or relying on specific vendor infrastructure.

主要功能

01Binary-search style narrowing to efficiently locate regressions

02Automated cleanup policy to remove instrumentation and logs after resolution

03Hypothesis-driven investigation framework to rank and test root causes

04Isolated local HTTP ingest logging via the debugsk utility

05Standardized reporting templates for consistent documentation of findings

060 GitHub stars

使用场景

01Debugging non-deterministic flaky tests in CI/CD pipelines

02Isolating regressions in complex microservices or frontend applications

03Investigating production incidents using structured logs and decisive signals

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add abekdwight/code-debug-skills code-debug-skill

For use in Claude.ai and ChatGPT

Download Skill