AL-JANEF/janef-forge / skills/engineering/root-cause-debugging
root-cause-debugging
VerifiedDiagnose regressions, flaky behavior, crashes, build errors, and unclear failures with an evidence loop: reproduce, bound, hypothesize, observe, fix the cause at the narrowest correct boundary, then add a regression test. Use for any bug report or failure before patching a symptom.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.6 KB |
| capability.json | config | 1.7 KB |
capability.json
View on GitHub{
"id": "root-cause-debugging",
"name": "Root-Cause Debugging",
"version": "2.0.0",
"domain": "engineering",
"description": "Diagnose regressions, flaky behavior, crashes, build errors, and unclear failures with an evidence loop: reproduce, bound, hypothesize, observe, fix the cause at the narrowest correct boundary, then add a regression test. Use for any bug report or failure before patching a symptom.",
"triggers": [
"bug",
"bugs",
"debug",
"debugging",
"flaky",
"failure",
"failing",
"fails",
"failed",
"crash",
"crashes",
"crashing",
"error",
"errors",
"exception",
"stack trace",
"traceback",
"broken",
"not working",
"does not work",
"doesn't work",
"intermittent",
"timeout",
"timeouts",
"hang",
"hangs",
"hanging",
"500s",
"reproduce",
"root cause",
"build error",
"build failure",
"build fails",
"compile error",
"type error",
"why does",
"why is",
"investigate",
"times out"
],
"negative_triggers": [],
"risk_level": "medium",
"context_cost": "small",
"requires": [],
"optional_with": [
"testing-verification",
"implementation-quality"
],
"conflicts_with": [],
"verification_requirements": [
"minimal reproduction recorded before the fix",
"regression test that fails on the original mechanism and passes after",
"nearby tests across the affected boundary"
],
"supported_hosts": [
"claude-code",
"codex"
],
"references": [],
"status": "stable",
"responsibilities": [
"failure-diagnosis",
"regression-reproduction"
],
"priority": 65,
"provenance": [
"lean-code-engineer 0.1.0 references/debugging.md"
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |