systematic-debugging SKILL.md skillA

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

Install it, pinned
mdr add taracodlabs/aiden/systematic-debugging@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
taracodlabs/aiden
Path
skills/systematic-debugging/SKILL.md
Versions recorded
3
Latest version
v1.0.0, committed May 6, 2026
First version recorded
Apr 17, 2026
Size
4,800 bytes
Repository stars
875
License
AGPL-3.0

Four-phase root cause investigation for bugs and unexpected behavior.

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

A structured four-phase process for diagnosing software bugs: **Reproduce → Isolate → Hypothesize → Verify**. Prevents guessing and ensures you find the root cause, not just a workaround.

## When to Use

- User reports a bug or unexpected behavior without an obvious cause
- An error message appears but the source is unclear
- A fix was applied but the problem persists
- Tests are failing intermittently (flaky tests)
- Production behavior differs from local behavior

## How to Use

### Phase 1: Reproduce reliably

A bug you can reproduce consistently is halfway solved.

```
1. Get the exact error message, stack trace, and environment
2. Identify exact steps to trigger the bug
3. Confirm the bug happens in a clean environment (not just local state)
4. Record: OS, runtime version, dependencies, config values
5. Try: does it fail on every run, or only sometimes?
```

If intermittent: add timing, logging, or retry logic to isolate the trigger.

### Phase 2: Isolate the failure

Narrow the failure to the smallest possible unit.

```
1. Add logging before/after suspected areas to find where state diverges
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add taracodlabs/aiden/systematic-debugging@sha256:c2f2916971d11ad9

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Apr 17, 2026 and May 6, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-05-06 ba6fa84 4,800 BA view · diff
v1.0.02026-04-17 a38c031 4,828 BA view · diff
v1.0.02026-04-17 9e46d41 4,808 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4800 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

taracodlabs/aiden · 875 stars · license AGPL-3.0 · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4huforkvjdh6frht
GET https://markdownregistry.com/api/v1/resolve?ref=taracodlabs/aiden/systematic-debugging
GET https://markdownregistry.com/api/v1/blob/c2f2916971d11ad95c300cbf7b559f9c1a923279933577e562764cdb8a803acd

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 taracodlabs/aiden

AGENTS.md AGENTS.md file
taracodlabs/aiden · AGENTS.md
git:20260711.5487b7f · audit A · 875 stars
architecture-diagram SKILL.md skill
taracodlabs/aiden · skills/architecture-diagram/SKILL.md · Architecture and component diagrams as HTML/SVG (dark-themed)
v1.0.0 · audit A · 875 stars
archon-bridge SKILL.md skill
taracodlabs/aiden · skills/archon-bridge/SKILL.md · Unified portfolio + order routing across Zerodha, Upstox, Angel One
v1.0.0 · audit A · 875 stars
arxiv SKILL.md skill
taracodlabs/aiden · skills/arxiv/SKILL.md · Search and download arXiv papers (no API key needed)
v1.0.0 · audit A · 875 stars
ascii-art SKILL.md skill
taracodlabs/aiden · skills/ascii-art/SKILL.md · ASCII text banners and box art (pyfiglet, cowsay, boxes)
v1.0.0 · audit A · 875 stars
blogwatcher SKILL.md skill
taracodlabs/aiden · skills/blogwatcher/SKILL.md · Monitor RSS / Atom feeds for new posts (Python feedparser)
v1.0.0 · audit A · 875 stars
censys SKILL.md skill
taracodlabs/aiden · skills/censys/SKILL.md · Censys lookups: hosts, certificates, services on the public internet
v1.0.0 · audit A · 875 stars
claude-code SKILL.md skill
taracodlabs/aiden · skills/claude-code/SKILL.md · Delegate coding and file edits to Anthropic Claude Code CLI
v1.0.0 · audit A · 875 stars
clipboard-history SKILL.md skill
taracodlabs/aiden · skills/clipboard-history/SKILL.md · Read/write Windows clipboard text, HTML, images, history (PowerShell)
v1.0.0 · audit A · 875 stars
code_execution SKILL.md skill
taracodlabs/aiden · skills/code_execution/SKILL.md · Running scripts and code on Windows
v1.0.0 · audit A · 875 stars
codex SKILL.md skill
taracodlabs/aiden · skills/codex/SKILL.md · Delegate coding tasks to OpenAI Codex CLI
v1.0.0 · audit A · 875 stars
crt.sh SKILL.md skill
taracodlabs/aiden · skills/crt-sh/SKILL.md · Enumerate subdomains and TLS certs via CT logs (no API key needed)
v1.0.0 · audit A · 875 stars

Every file in taracodlabs/aiden

Other files named systematic-debugging

systematic-debugging SKILL.md skill
obra/superpowers · skills/systematic-debugging/SKILL.md · Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
git:20261010.bb92a77 · audit A · 314,583 stars
systematic-debugging SKILL.md skill
mvschwarz/openrig · skills/_canonical/process/systematic-debugging/SKILL.md · Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
git:20261025.a37e271 · audit A · 8,636 stars
systematic-debugging SKILL.md skill
mvschwarz/openrig · packages/daemon/specs/agents/shared/skills/process/systematic-debugging/SKILL.md · Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
git:20261025.a37e271 · audit A · 8,636 stars
systematic-debugging SKILL.md skill
jnmetacode/superpowers-zh · skills/systematic-debugging/SKILL.md · 遇到任何 bug、测试失败或异常行为时使用,在提出修复方案之前执行
v1.0.0 · audit A · 8,494 stars
systematic-debugging SKILL.md skill
cbrock84/headcount · plugins/technology/skills/systematic-debugging/SKILL.md · Finds the root cause of a bug, test failure, or unexpected behavior before proposing any fix. Use this whenever…
git:20260901.aa45383 · audit A · 2,543 stars
systematic-debugging SKILL.md skill
a5c-ai/babysitter · library/methodologies/superpowers/skills/systematic-debugging/SKILL.md · Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes. Requires root cause…
git:20260601.da7723a · audit A · 1,896 stars
systematic-debugging SKILL.md skill
a5c-ai/babysitter · library/methodologies/rpikit/skills/systematic-debugging/SKILL.md · Structured debugging methodology using hypothesis-driven investigation, log analysis, and bisection to isolate and…
git:20260605.09bdbf7 · audit A · 1,896 stars
systematic-debugging SKILL.md skill
ganyuanran/aegis · skills/systematic-debugging/SKILL.md · Use when encountering a bug, test failure, or unexpected behavior, before proposing fixes
git:20261025.21787f7 · audit A · 1,417 stars

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