Home / ethanyoq / skill-hub · archives/user-installed-skills/systematic-debugging/040ea7242bd82f9a/systematic-debugging/SKILL.md · GitHub

systematic-debugging skillA

Name: systematic-debugging
Author: ethanyoq

This file is byte-identical to the first copy the registry indexed, one of 4 copies on public GitHub. Same content hash, same audit grade.

systematic-debugging is agent-read markdown (skill) from ethanyoq/skill-hub: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

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

## Overview

**Core principle:** ALWAYS find root cause before attempting fixes. Symptom fixes are failure.

**Violating the letter of this process is violating the spirit of debugging.**

## The Iron Law

```
NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
```

If you haven't completed Phase 1, you cannot propose fixes.

## When to Use

Use for ANY technical issue:
- Test failures
- Bugs in production
- Unexpected behavior
- Performance problems
- Build failures
- Integration issues

**Use this ESPECIALLY when:**
- Under time pressure (emergencies make guessing tempting)
- "Just one quick fix" seems obvious
- You've already tried multiple fixes
- Previous fix didn't work
- You don't fully understand the issue

**Don't skip when:**
- Issue seems simple (simple bugs have root causes too)
- You're in a hurry (rushing guarantees rework)
- Manager wants it fixed NOW (systematic is faster than thrashing)

## The Four Phases

You MUST complete each phase before proceeding to the next.

### Phase 1: Root Cause Investigation

**BEFORE attempting ANY fix:**

1. **Read Error Messages Carefully**
   - Don't skip past errors or warnings
…

Read the whole file at its exact version.

How to install

Latest version

mdr add ethanyoq/skill-hub/systematic-debugging@git:20260919.e8b19bf

Exact content

mdr add ethanyoq/skill-hub/systematic-debugging@sha256:808fc5717aa88ad6

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](https://markdownregistry.com/badge/art_qrmb6ooqjdqk6ece.svg)](https://markdownregistry.com/a/art_qrmb6ooqjdqk6ece)

1 badge views in 30 days

Versions

version	committed	commit	size	audit
git:20260919.e8b19bf latest	2026-09-19	e8b19bf	9,465 B	A	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 (9465 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

ethanyoq/skill-hub · 10 stars · license MIT · pushed 2026-09-19 · branch mine

API

GET https://markdownregistry.com/api/v1/artifacts/art_qrmb6ooqjdqk6ece
GET https://markdownregistry.com/api/v1/resolve?ref=ethanyoq/skill-hub/systematic-debugging
GET https://markdownregistry.com/api/v1/blob/808fc5717aa88ad65efff312b11c186294d3e6ee301afb584e2f86599b137787

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 ethanyoq/skill-hub

AGENTS.md agents

ethanyoq/skill-hub · AGENTS.md

git:20260730.c96ba6e · audit A · 10 stars

aact-bulk-trials skill

ethanyoq/skill-hub · archives/user-installed-skills/aact-bulk-trials/e07736f27453c7b6/aact-bulk-trials/SKILL.md · 使用 AACT (Aggregate Analysis of ClinicalTrials.gov) PostgreSQL 数据仓库进行批量、历史、聚合性临床试验数据挖掘。Use this skill when the user…

git:20260912.c74de71 · audit A · 10 stars

aact-bulk-trials skill

ethanyoq/skill-hub · archives/user-installed-skills/aact-bulk-trials/e171d39ba5bce7c9/aact-bulk-trials/SKILL.md · 使用 AACT (Aggregate Analysis of ClinicalTrials.gov) PostgreSQL 数据库进行大批量临床试验历史分析与数据挖掘。触发场景包括：AACT 查询、临床试验批量分析、PostgreSQL…

git:20260912.c74de71 · audit A · 10 stars

adaptive-quality-gate skill

ethanyoq/skill-hub · archives/user-installed-skills/adaptive-quality-gate/b5189ce6c1bdba9b/adaptive-quality-gate/SKILL.md · Use when work produces a deliverable, factual claim, dataset, code change, decision, publication, deployment…

git:20260912.c74de71 · audit A · 10 stars

add-changeset skill

ethanyoq/skill-hub · archives/user-installed-skills/add-changeset/eca9273317fbdf81/add-changeset/SKILL.md · Create a changeset file in .changeset/ that describes a user-facing change for the release notes