Individual skill

systematic-debugging

0upvotes

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

skills/systematic-debugging/SKILL.md

Read pinned source

Source commit b436d6bb494c8731c8181783f75fdc5c28013912

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: No
Observed behavior: Network or broad shell
Last checked: Nov 10, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 991
Repository last updated: Nov 8, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

ai-skills Repository topic
workflows Repository topic
skills Repository topic
anthropic-skills Repository topic
planning Repository topic
superpowers Repository topic
context-engineering Repository topic
ui-ux-design Repository topic
ai-agents Repository topic
claude-code Repository topic
testing Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

CREATION-LOG.mddoc · 4,257 bytes
SKILL.mdcore · 9,530 bytes
SKILL.mdcore · 9,530 bytes
condition-based-waiting-example.tsruns · 5,054 bytes
condition-based-waiting.mddoc · 3,516 bytes
defense-in-depth.mddoc · 3,650 bytes
find-polluter.shruns · 1,986 bytes
root-cause-tracing.mddoc · 5,321 bytes
test-academic.mddoc · 653 bytes
test-pressure-1.mddoc · 1,900 bytes
test-pressure-2.mddoc · 2,283 bytes
test-pressure-3.mddoc · 2,692 bytes

Read excerpt


# 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
```