Home / fmind / dot · skills/systematic-debugging/SKILL.md · GitHub

systematic-debugging skillA

systematic-debugging is agent-read markdown (skill) from fmind/dot: Diagnose failures, DNS/TLS, and Python CPU or memory issues with Pyinstrument and Memray..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Systematic Debugging

Replace guess-and-check with an evidence loop that localizes where and why behavior diverges; [python-testing](../python-testing/SKILL.md) implements the fix and [incident-response](../incident-response/SKILL.md) owns live outages.

## Workflow

1. **Preserve evidence**: Capture the exact error, stack trace, command, inputs, versions, environment differences, timing, and recent changes before touching anything.
1. **Reproduce**: Find the shortest reliable command or sequence; for intermittent failures record the frequency and vary one dimension at a time.
1. **Reduce**: Minimize input, fixture, process count, and component path while keeping the same failure, preferably as a focused test or disposable harness.
1. **Localize**: Trace bad state backward across calls, processes, network boundaries, configuration, and generated artifacts; at each boundary compare what entered with what left.
1. **Find a working comparator**: Locate the nearest known-good test, code path, version, environment, or commit and list every relevant difference before choosing one.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add fmind/dot/systematic-debugging@git:20260919.4491844
Exact content
mdr add fmind/dot/systematic-debugging@sha256:ec2a0e5c678d79c7

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

0 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260919.4491844 latest2026-09-19 4491844 5,201 BA view · diff
git:20260916.50d68102026-09-16 50d6810 5,167 BA view · diff
git:20260913.ef230602026-09-13 ef23060 5,190 BA view · diff
git:20260911.616be7a2026-09-11 616be7a 5,010 BA view · diff
git:20260909.892d8592026-09-09 892d859 4,987 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (5201 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

fmind/dot · 9 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_c6ndjwrj2zsl3s5r
GET https://markdownregistry.com/api/v1/resolve?ref=fmind/dot/systematic-debugging
GET https://markdownregistry.com/api/v1/blob/ec2a0e5c678d79c711315ea82400e1b7bd58a5c133fbbad20108048a8bc33a67

Your agent 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.

More from fmind/dot

chezmoi skill
fmind/dot · .agents/skills/chezmoi/SKILL.md · Manage chezmoi source names, templates, secrets, diffs, and deployment in fmind/dot.
git:20260920.d5fedf5 · audit A · 9 stars
dot-development skill
fmind/dot · .agents/skills/dot-development/SKILL.md · Develop fmind/dot CLI commands, session parsers, storage, configuration, and installation.
git:20260920.d5fedf5 · audit A · 9 stars
dot-release skill
fmind/dot · .agents/skills/dot-release/SKILL.md · Prepare, publish, recover, and verify fmind/dot releases through the repository task.
git:20260920.d5fedf5 · audit A · 9 stars
dot-skills skill
fmind/dot · .agents/skills/dot-skills/SKILL.md · Maintain fmind/dot skill packages, catalog budgets, routing contracts, and installed links.
git:20260920.d5fedf5 · audit A · 9 stars
dot-verify skill
fmind/dot · .agents/skills/dot-verify/SKILL.md · Qualify the fmind/dot working tree before a release: review changes, sync docs, run every gate, and smoke-test the dot…
git:20260924.4be3d0c · audit A · 9 stars
AGENTS.md agents
fmind/dot · AGENTS.md
git:20260920.d5fedf5 · audit A · 9 stars
CLAUDE.md claude
fmind/dot · CLAUDE.md
git:20260903.fa1d8bb · audit B · 9 stars
AGENTS.md@dot_agents agents
fmind/dot · dot_agents/AGENTS.md
git:20260920.d5fedf5 · audit A · 9 stars
acli skill
fmind/dot · skills/acli/SKILL.md · Search, plan, and update Atlassian Jira and Confluence with acli.
git:20260920.d5fedf5 · audit A · 9 stars
agent-evaluation skill
fmind/dot · skills/agent-evaluation/SKILL.md · Evaluate prompt, model, retrieval, and agent changes through repeated trials and outcome grading.
git:20260916.50d6810 · audit A · 9 stars
agent-frameworks skill
fmind/dot · skills/agent-frameworks/SKILL.md · Build Python agents with Google ADK, LangChain, LangGraph, and agents-cli: tools, state, and retrieval.
git:20260916.50d6810 · audit A · 9 stars
agent-harnesses skill
fmind/dot · skills/agent-harnesses/SKILL.md · Operate and configure Claude Code, Codex, Copilot, Grok, and OpenCode.
git:20260919.afe8ee0 · audit A · 9 stars

Every file in fmind/dot

Other files named systematic-debugging

systematic-debugging skill
obra/superpowers · skills/systematic-debugging/SKILL.md · Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
git:20260724.c74782e · audit A · 291,204 stars
systematic-debugging skill
jnmetacode/superpowers-zh · skills/systematic-debugging/SKILL.md · 遇到任何 bug、测试失败或异常行为时使用,在提出修复方案之前执行
v1.0.0 · audit A · 8,203 stars
systematic-debugging 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,809 stars
systematic-debugging 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,809 stars
systematic-debugging skill
ganyuanran/aegis · skills/systematic-debugging/SKILL.md · Use when encountering a bug, test failure, or unexpected behavior, before proposing fixes
git:20260907.f725a76 · audit A · 1,280 stars
systematic-debugging skill
mateaix/mateclaw · mateclaw-server/src/main/resources/skills/systematic-debugging/SKILL.md · 4-phase root cause debugging: understand bugs before fixing.
v1.1.0 · audit A · 1,127 stars
systematic-debugging skill
sethgammon/citadel · skills/systematic-debugging/SKILL.md · 4-phase root cause analysis: observe, hypothesize, verify, fix. Enforces investigation before any code changes…
git:20260624.445e974 · audit A · 923 stars
systematic-debugging skill
taracodlabs/aiden · skills/systematic-debugging/SKILL.md · Four-phase root cause investigation for bugs and unexpected behavior
v1.0.0 · audit A · 843 stars

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