systematic-debugging SKILL.md skillA

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

Install it, pinned
mdr add andreymudri/fleetmates/systematic-debugging@git:20261005.c00f407

Pins git:20261005.c00f407 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
andreymudri/fleetmates
Path
skills/systematic-debugging/SKILL.md
Versions recorded
4
Latest version
git:20261005.c00f407, committed Oct 5, 2026
First version recorded
Aug 5, 2026
Size
5,910 bytes
Repository stars
3
License
MIT

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes - reproduce and isolate before changing anything.

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

_Adapted from the MIT-licensed superpowers plugin by Jesse Vincent. See NOTICE.md._

## Overview

**Core principle:** find the root cause before attempting a fix. A fix aimed at a symptom
without a confirmed cause is a guess, and guesses are how debugging sessions run for hours
without progress.

## The Loop

One step at a time. Do not skip ahead to a fix because the cause "seems obvious."

1. **Reproduce reliably.** Trigger the bug on demand, with exact steps. If you can't
   reproduce it consistently, gather more evidence before doing anything else — don't guess
   at a fix for a bug you can't summon.
2. **Minimise the reproduction.** Strip away everything not required to trigger it: unrelated
   setup, unrelated input, unrelated code paths. A smaller reproduction narrows where the
   cause can be.
3. **State a hypothesis that predicts something observable.** "I think X is the cause because
   Y, and if true then Z will happen when I do W." A hypothesis that can't fail — one with no
   observable prediction — is not a hypothesis, it's a guess wearing a hypothesis's clothes.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add andreymudri/fleetmates/systematic-debugging@sha256:6af8b6ea3de81cba

The line at the top of this page pins the label git:20261005.c00f407, 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_4fsw3mh4g67tx64m.svg)](https://markdownregistry.com/a/art_4fsw3mh4g67tx64m)

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

Versions

The registry has recorded 4 versions of this file, between Aug 5, 2026 and Oct 5, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20261005.c00f407 latest2026-10-05 c00f407 5,910 BA view · diff
git:20260805.b93e2ac2026-08-05 b93e2ac 4,725 BA view · diff
git:20260805.61bebf62026-08-05 61bebf6 4,223 BA view · diff
git:20260805.59987392026-08-05 5998739 4,079 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 (5910 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

andreymudri/fleetmates · 3 stars · license MIT · pushed 2026-11-06 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_4fsw3mh4g67tx64m
GET https://markdownregistry.com/api/v1/resolve?ref=andreymudri/fleetmates/systematic-debugging
GET https://markdownregistry.com/api/v1/blob/6af8b6ea3de81cba938bb496cd2524ecdf09913a4a1edd7d165a71f4e506203c

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 andreymudri/fleetmates

AGENTS.md AGENTS.md file
andreymudri/fleetmates · AGENTS.md
git:20261028.fbb34e3 · audit A · 3 stars
brainstorming SKILL.md skill
andreymudri/fleetmates · skills/brainstorming/SKILL.md · Use when starting any creative work - creating features, building components, adding functionality, or modifying…
git:20261102.7d75f08 · audit A · 3 stars
executing-plans SKILL.md skill
andreymudri/fleetmates · skills/executing-plans/SKILL.md · Use when you have a written implementation plan to execute inline in this session, with checkpoints - the non-fleet…
git:20260916.b8baf3a · audit A · 3 stars
finishing-a-development-branch SKILL.md skill
andreymudri/fleetmates · skills/finishing-a-development-branch/SKILL.md · Use when implementation is complete and needs integrating - re-runs the gate to verify each phase, then decides how the…
git:20261103.344e4c8 · audit A · 3 stars
fleet-lifecycle SKILL.md skill
andreymudri/fleetmates · skills/fleet-lifecycle/SKILL.md · Use when spawning, listing, messaging, scaling, stopping, or resuming background teammates on a run.
git:20260916.b8baf3a · audit A · 3 stars
fleet-supervision SKILL.md skill
andreymudri/fleetmates · skills/fleet-supervision/SKILL.md · Use when checking what a running fleet is doing - renders the digest, surfaces blocked or failed teammates, and…
git:20261102.f025044 · audit A · 3 stars
fleetmates-config SKILL.md skill
andreymudri/fleetmates · skills/fleetmates-config/SKILL.md · Use when changing how the fleet runs — parallelism, or model tier or effort per role.
git:20260917.bf6393b · audit A · 3 stars
grilling SKILL.md skill
andreymudri/fleetmates · skills/grilling/SKILL.md · Use when a plan, spec or design still has unresolved decisions, when the user says "grill me" or asks to be…
git:20261102.7d75f08 · audit A · 3 stars
parallel-execution SKILL.md skill
andreymudri/fleetmates · skills/parallel-execution/SKILL.md · Use when executing a written plan across background teammates - splits it into phases, dispatches worktree-isolated…
git:20261102.f025044 · audit A · 3 stars
phase-gate SKILL.md skill
andreymudri/fleetmates · skills/phase-gate/SKILL.md · Use when a phase finished and needs an automated verdict before integration - runs command, agent, and MCP checks and…
git:20261103.344e4c8 · audit A · 3 stars
receiving-code-review SKILL.md skill
andreymudri/fleetmates · skills/receiving-code-review/SKILL.md · Use when receiving code review feedback, before implementing suggestions - requires technical verification rather than…
git:20260805.36003db · audit A · 3 stars
test-driven-development SKILL.md skill
andreymudri/fleetmates · skills/test-driven-development/SKILL.md · Use when implementing any feature or bugfix, before writing implementation code - write the failing test first and…
git:20260805.6da0f10 · audit A · 3 stars

Every file in andreymudri/fleetmates

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.