borghei/Claude-Skills / engineering/bug-diagnosis
bug-diagnosis
VerifiedFind the root cause of hard bugs with a fast pass/fail repro, ranked falsifiable hypotheses and bisection. Use when a bug resists quick fixes, a failure is intermittent, or a regression needs tracing to its cause.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.3 KB |
| assets/diagnosis-log-template.md | markdown | 1.9 KB |
| assets/repro-script-template.sh | script | 1.4 KB |
| assets/sample_debug_log.txt | markdown | 1.0 KB |
| assets/sample_diagnosis_log.json | config | 1.6 KB |
| assets/sample_diagnosis_log_passing.json | config | 1.8 KB |
| references/bisection-instrumentation-redaction.md | markdown | 8.7 KB |
| references/reproduction-signals.md | markdown | 7.8 KB |
| scripts/hypothesis_log.pyexecutable | script | 10.2 KB |
| scripts/redact_scan.pyexecutable | script | 8.3 KB |
assets/sample_diagnosis_log_passing.json
View on GitHub{
"bug": "Nightly export job hangs on accounts with more than 10k invoices",
"status": "investigating",
"repro": {
"command": "python -m export.cli --account fixtures/acct_10001.json --timeout 5",
"runs": 10,
"red_runs": 10,
"runtime_seconds": 4,
"asserts_symptom": true,
"minimised": true
},
"hypotheses": [
{
"id": "H1",
"statement": "The paginator re-requests the last page when the total is an exact multiple of the page size",
"prediction": "If the paginator loops on the final page, then a fixture with 10000 invoices hangs and one with 10001 completes",
"experiment": "Run the loop against fixtures with 10000 and 10001 invoices and compare",
"prior": 0.45,
"cost_minutes": 5,
"status": "open"
},
{
"id": "H2",
"statement": "A database lock taken by the invoice-total trigger blocks the export cursor",
"prediction": "If the trigger lock is the cause, then disabling the trigger in the test database makes the job finish",
"experiment": "Disable the trigger in the fixture database and rerun the loop",
"prior": 0.3,
"cost_minutes": 20,
"status": "open"
},
{
"id": "H3",
"statement": "The CSV writer buffers the whole export in memory and stalls in swap",
"prediction": "If memory pressure is the cause, then peak RSS climbs past 2 GB before the hang",
"experiment": "Record peak RSS during the loop with the standard resource module",
"prior": 0.15,
"cost_minutes": 10,
"status": "refuted",
"evidence": "Peak RSS stayed at 180 MB across 10 red runs"
}
],
"experiments": [
{
"hypothesis": "H3",
"change": "Sampled peak RSS during the run",
"variables_changed": ["measurement only"],
"result": "refuted"
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |