Skip to content

matt-bat/got-skills / skills/diagnose-before-fix

diagnose-before-fix

Verified

Use for debugging or remediation work when reported symptoms may not be the true root cause; verify the cause independently before applying fixes, even when the user suggests one.

Diagnose Before Fix

Quick Index (Action-Routed)

Read First (All Actions)

  1. Mission
  2. Trigger Rule
  3. Cause Verification Standard

Action Modules (Read As Needed)

  1. Reproducing and isolating failures:
    • Symptom Capture
    • Hypothesis Testing
  2. Choosing a fix path:
    • Root Cause Decision Rule
  3. Confirming the repair:
    • Verification After Fix

Output

  1. Output Contract

Mission

Separate observed symptoms from verified causes so fixes address the actual failure mode.

Trigger Rule

Use this skill when:

  1. a user reports a bug, error, regression, or broken behavior
  2. the user suggests a cause but it is not yet proven
  3. multiple plausible root causes exist
  4. a quick patch would risk masking the true problem

Treat user-provided causes as hypotheses, not facts, until verified.

Cause Verification Standard

Before changing behavior:

  1. reproduce the symptom or inspect direct evidence
  2. test the proposed cause explicitly
  3. compare at least one alternative explanation when feasible
  4. only fix the verified root cause

If the root cause cannot be verified:

  1. say so plainly
  2. limit changes to safe mitigation
  3. preserve evidence for the next pass

Symptom Capture

Record the failure in concrete terms:

  1. what fails
  2. where it fails
  3. when it fails
  4. what changed recently

Hypothesis Testing

Test from cheapest to most informative:

  1. direct logs or stack traces
  2. targeted reproduction
  3. narrow code-path inspection
  4. focused unit or integration check

Root Cause Decision Rule

Do not patch a visible symptom unless:

  1. the cause is verified, or
  2. the change is explicitly a temporary mitigation and is labeled as such

Verification After Fix

After a fix:

  1. rerun the reproducer or targeted check
  2. confirm the original symptom is gone
  3. confirm adjacent behavior still works

Output Contract

When using this skill, provide:

  1. symptom description
  2. tested hypotheses
  3. verified cause or verified uncertainty
  4. fix applied or mitigation chosen
  5. post-fix validation summary

Related Skills

Least-resistance reasoning

Prefer the simplest explanation that fits the evidence. Test the cheapest reversible hypothesis first, and add complexity only when a failed test or new evidence requires it. Keep the claim falsifiable by naming what would confirm or disconfirm it.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall