systematic-debugging SKILL.md skillA

systematic-debugging from mehranqadirian/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add mehranqadirian/skills/systematic-debugging@git:20261101.7852a8a

Pins git:20261101.7852a8a in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

mehranqadirian/skills

Path

git/systematic-debugging/SKILL.md

Versions recorded

2

Latest version

git:20261101.7852a8a, committed Nov 1, 2026

First version recorded

Nov 1, 2026

Size

4,571 bytes

Repository stars

13

License

none declared

Debugs by evidence instead of guessing. Use whenever a test fails, behavior regressed, a bug is intermittent or environment-specific, or the user needs to find which commit introduced a defect, even if they only say "this is broken" or "why does this fail". Reproduces, isolates and proves the root cause, then locks the fix with a regression test. Uses git bisect, blame and reflog.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# systematic-debugging

Debug by evidence, not by guessing. Each step narrows the search space until the root cause is proven and a regression test locks the fix.

```
systematic-debugging/
├── SKILL.md
├── scripts/
│   ├── bisect_helper.sh     safe `git bisect run` wrapper with sanity checks and automatic reset
│   └── flaky_runner.sh      run a command N times, report failure rate, save first failure log
├── references/
│   ├── bisect-playbook.md   preconditions, exit codes, merge commits, skipping, after the hit
│   └── flaky-and-env.md     flaky test causes, "works on my machine" checklist, delta debugging
└── templates/
    └── bug-report.md        report with evidence, root cause, regression test, verification
```

## When to use

- A test fails or behavior regressed
- A bug is intermittent or environment-specific
- You need the exact commit that introduced a defect

## Method

1. **Reproduce**: build the smallest reliable failing case. If it is intermittent, measure the rate with `scripts/flaky_runner.sh`.
2. **Observe**: collect logs, stack traces, inputs and versions.
…

Read the whole file at its exact version.

How to install

mdr add mehranqadirian/skills/systematic-debugging@sha256:9f3a307c46a3a4b2

[![mdr](https://markdownregistry.com/badge/art_3gzbek5bau2w3nbm.svg)](https://markdownregistry.com/a/art_3gzbek5bau2w3nbm)

Versions

The registry has recorded 2 versions of this file, all committed on Nov 1, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_3gzbek5bau2w3nbm
GET https://markdownregistry.com/api/v1/resolve?ref=mehranqadirian/skills/systematic-debugging
GET https://markdownregistry.com/api/v1/blob/9f3a307c46a3a4b29fff1e4095de5b9bd3812b44723924058f5f8f2d0eca3391

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mehranqadirian/skills

Every file in mehranqadirian/skills

Other files named systematic-debugging

Browse by kind, by grade A, or by owner.