Bug Diagnosis
Find 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.
Install
/plugin marketplace add borghei/Claude-SkillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add borghei/Claude-Skills --skill bug-diagnosisgit clone --depth 1 https://github.com/borghei/Claude-Skills.git /tmp/Claude-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Claude-Skills/engineering/bug-diagnosis ~/.claude/skills/bug-diagnosisPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Bug Diagnosis A disciplined loop for bugs that survived the first obvious fix. The order is fixed: build a signal that says "bug present / bug absent" in seconds, write down competing explanations with predictions that could prove them wrong, test the cheapest likely one, narrow the search space by halving, and lock the cause in with a regression test that was seen failing. Most wasted debugging time comes from skipping the first step and reading code to build a theory with nothing to check it against. ## When to use this skill - **A bug resisted a first fix** — the patch went in and the symptom came back, or moved - **The failure is intermittent** — passes locally, fails in CI one run in five - **A regression appeared between two releases** and nobody knows which change caused it - **The symptom is far from the cause** — wrong totals, corrupted records, a hang with no error - **A performance regression** needs a measured cause rather than a guess - **Logs or traces need sharing** with a teammate, vendor or assistant and may contain credentials ## Inputs the skill expects - The reported symptom in exact terms: error text, wrong value, measured latency - Where it reproduces (local, CI, staging, production only) and how often - The last known-good state if one exists: a release, a commit, a dataset, a flag set - Access the agent has: can it run the code, the tests, a local database, `git bisect`?
Details
- Skill name
bug-diagnosis- Repository
- borghei/Claude-Skills
- Path
engineering/bug-diagnosis/SKILL.md- Repo updated
- 8 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Bug Diagnosis skill do?
Find 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.
How do I install the Bug Diagnosis skill?
Claude Code plugin: /plugin marketplace add borghei/Claude-Skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Bug Diagnosis popular?
It lives in borghei/Claude-Skills, which has 1,157 GitHub stars and 217 forks, and is included in 1 curated skill list.
Related skills
Cto Advisor
1.2kborghei/Claude-Skills
Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Use when assessing technical debt, scaling engineering teams, evaluating technologies, or making architecture decisions.
Customer Success Manager
1.2kborghei/Claude-Skills
Monitors customer health, predicts churn risk, and identifies expansion opportunities using weighted scoring models for SaaS customer success
Financial Analyst
1.2kborghei/Claude-Skills
Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making
Ccpa Cpra Privacy Expert
1.2kborghei/Claude-Skills
CCPA and CPRA California privacy compliance. Use for CCPA/CPRA readiness assessments, personal information data mapping, consumer rights handling, privacy policy review, opt-out mechanisms, and California privacy audits.
Activation Funnel
1.2kborghei/Claude-Skills
Designs and analyzes activation funnels: stage conversion, drop-off, bottlenecks and the aha event that predicts retention. Use when a funnel leaks, signups grow but activation is flat, or you must pick an activation event.
Cs Onboard
1.2kborghei/Claude-Skills
Structured C-suite onboarding via a founder interview that captures company context into a persistent file used by all advisory skills. Use when setting up advisory context, refreshing stale context, or onboarding a new executive.
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.