Home / kunanonj / ai-skills-hub · .agents/skills/systematic-debugging/SKILL.md · GitHub

systematic-debugging skillA

Name: systematic-debugging
Author: kunanonj

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 kunanonj/ai-skills-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

Random fixes waste time and create new bugs. Quick patches mask underlying issues.

**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:**
…

Read the whole file at its exact version.

How to install

Latest version

mdr add kunanonj/ai-skills-hub/systematic-debugging@git:20260628.caecf60

Exact content

mdr add kunanonj/ai-skills-hub/systematic-debugging@sha256:4999cb851360485e

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

1 badge views in 30 days

Versions

version	committed	commit	size	audit
git:20260628.caecf60 latest	2026-06-28	caecf60	9,884 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 (9884 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

kunanonj/ai-skills-hub · 5 stars · license MIT · pushed 2026-09-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5pjovv2y7glac7o7
GET https://markdownregistry.com/api/v1/resolve?ref=kunanonj/ai-skills-hub/systematic-debugging
GET https://markdownregistry.com/api/v1/blob/4999cb851360485eca5074e727bbdd62ef20549c5d5b01216fcbf5831badb473

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 kunanonj/ai-skills-hub

analyze-codebase-for-mcp skill

kunanonj/ai-skills-hub · .agents/skills/analyze-codebase-for-mcp/SKILL.md · Analyze an arbitrary codebase to identify functions, APIs, and data sources suitable for exposure as MCP tools…

v1.0 · audit A · 5 stars

api-analyzer skill

kunanonj/ai-skills-hub · .agents/skills/api-analyzer/SKILL.md · Validates whether an API request is correct based on provided inputs (method, URL, headers, body, auth, query params)…

v1.0 · audit A · 5 stars

api-design-principles skill

kunanonj/ai-skills-hub · .agents/skills/api-design-principles/SKILL.md · Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight…