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.

1,157 stars 217 forksOther Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add borghei/Claude-Skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add borghei/Claude-Skills --skill bug-diagnosis
Manual install
git 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-diagnosis

Personal 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`?
Read the full skill on GitHub

Details

Skill name
bug-diagnosis
Path
engineering/bug-diagnosis/SKILL.md
Repo updated
8 November 2026

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.2k

borghei/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.

Software DevelopmentIn 1 list217

Customer Success Manager

1.2k

borghei/Claude-Skills

Monitors customer health, predicts churn risk, and identifies expansion opportunities using weighted scoring models for SaaS customer success

Marketing, Sales & BusinessIn 1 list217

Financial Analyst

1.2k

borghei/Claude-Skills

Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making

Finance & CryptoIn 1 list217

Ccpa Cpra Privacy Expert

1.2k

borghei/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.

OtherIn 1 list217

Activation Funnel

1.2k

borghei/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.

OtherIn 1 list217

Cs Onboard

1.2k

borghei/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.

OtherIn 1 list217

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.