Skip to content
Skills Library
Programming · Analysis

debug-triage

/debug-triage

Use when something is broken and the cause is not yet established: a bug report, a pasted stack trace or error log, a failing or flaky test, a crash, hang, or regression, \"X is not working\", or \"why is this happening\", before any fix is proposed.

Licence
MIT
Last repository change
15.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 15.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when something is broken and the cause is not yet established: a bug report, a pasted stack trace or error log, a failing or flaky test, a crash, hang, or regression, \"X is not working\", or \"why is this happening\", before any fix is proposed.

Triggers from the description

X is not working\why is this happening\
Original author description

Use when something is broken and the cause is not yet established: a bug report, a pasted stack trace or error log, a failing or flaky test, a crash, hang, or regression, \"X is not working\", or \"why is this happening\", before any fix is proposed.

How it works

  1. Inputs
  2. Steps (do not skip)
  3. Parallel hypotheses
  4. Output
  5. Workflow context
  6. Output contract
Original SKILL.md headings · 62 lines, 495 words
SKILL.md preview
---
name: debug-triage
description: "Use when something is broken and the cause is not yet established: a bug report, a pasted stack trace or error log, a failing or flaky test, a crash, hang, or regression, \"X is not working\", or \"why is this happening\", before any fix is proposed."
---

# Debug triage

> Delegation, model labels, and task tracking below use Claude Code notation. In Codex or another client, follow `../../references/cross-client.md`.

Cause already established (applying a reviewed finding, a fix the user has diagnosed)? Implement it
directly; this skill is for finding the cause.

## Inputs
Bug report or steps, error messages and stack traces, environment (prod/staging/local), version and
flag state, recent deploys, config changes, or migrations.

## Steps (do not skip)
1. **Establish the failure first.** Reproduce it when safe and record exact steps. For production-only,
   destructive, intermittent, or expired failures, capture a precise evidence signature (error,
   timestamps, IDs, affected tenants) and build the closest safe falsifiable proxy (a failing test,
   a replayed request against local) instead of forcing reproduction in production.
2. **Fast checks** before deep dives: flag state, recent deploy, config change, or migration, the log
   signature around the failure window, a working-versus-failing account or data diff.
3. **Hypotheses**: two or three, ranked with reasoning, each with the cheapest check that confirms
   or kills it. Read the actual code path; never patch from symptom pattern-matching.
4. **Bisect** when history matters and the checkout or environment can be isolated safely
   (`git bisect`, toggling recent changes).
5. **Root cause before fix.** No code fix until a hypothesis is confirmed by evidence. During an active
   incident, mitigation (rollback, flag off) may come first; that belongs to `incident-response` and
   does not replace finding the cause.
6. **Minimal fix at the root cause**, not where the symptom surfaced. One change at a time, no
   drive-by refactors, and strip temporary logging or debug flags before committing. Check whether the
   same defect exists in sibling code paths.
7. **Regression test** that fails without the fix and passes with it.
8. **Three failed fixes: stop changing code.** Write down what is known and unknown, discard disproved
   hypotheses, and re-question the model of the system before another change.

When the user asked "why" rather than "fix it", or another skill (for example `verify-impl`) routed the
failure here, the diagnosis is the deliverable: report it and let the user choose the fix.

Money and data bugs: confirm whether bad writes already happened (wrong balances, duplicate
postings). A code fix does not repair data; list affected records and propose a reviewed correction
with a restore path, and never rewrite data without explicit confirmation.

## Parallel hypotheses
Investigate inline by default. Only when three or more independent hypotheses each need substantial
log or code reading, run one agent per hypothesis and stop the others once one is confirmed.
Dependent hypotheses (B only matters if A is true) stay sequential.

## Output
Fill `assets/triage-report.md`.

## Workflow context
- `incident-response` handles an active outage (mitigate first); this skill finds the cause; `postmortem` reviews after resolution.
- Receives failures from `verify-impl`; feeds regression cases to `test-plan` and severe cases to `postmortem`.

## Output contract
```yaml
produces:
  - type: "triage"
    format: "markdown"
    path: "claudedocs/<feature>-debug-triage.md"
    sections: [reproduction, hypotheses, investigation_plan, fix_strategy]
    handoff: "Write claudedocs/handoff-debug-triage-<timestamp>.yaml - suggest: postmortem, test-plan"
```
Files in this package (2)
  • SKILL.md 4 KB
  • assets/triage-report.md 1 KB

Versions

RepositoryScoreLicence
This page · omexit/claude-skills-pack100MIT
sagargupta16/claude-skills100MIT
iuliandita/skills90MIT

Database snapshot: 13.11.2026 · package version 195d3c1cb6a6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100debugging
    Use this skill when something is broken and the cause is unknown — a failing test, a crash, an error message, wrong output, a regression, a hang, or behaviour that differs between environments — and it has to be found and fixed at the root. Also use it to build the failing proof…
  • 100debug-detective
    Find the root cause of a bug, crash, error message or failing test, then fix it. Use when the user says "this is broken", "why does this fail", "I get this error", "the test is failing", "it worked yesterday", or pastes a stack trace.
  • 100debug-issue
    Systematic debugging workflow for any code error, crash, test failure, or unexpected behavior. Use this skill whenever a user mentions an error, bug, exception, crash, test failure, or says something "isn't working", "is broken", "keeps failing", or "isn't behaving as expected"…
  • 100debugging
    A systematic method for finding the root cause of a bug, crash, error, or wrong output — reproduce, isolate, hypothesize, test, fix. Use when users report something broken, an exception/stack trace, flaky behavior, or 'why doesn't this work'. Triggers on mentions of bug, error,…
  • 91systematic-debugging
    Use when a bug, failing or flaky test, production incident, unexpected output, or performance regression has an unknown cause.
  • 100systematic-debug
    Finds the root cause of a bug before any fix is written, including failures that cross component boundaries. Use when the user says debug, broken, failing, flaky, or root cause, pastes a stack trace or error log, or tests fail unexpectedly.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.