Diagnosing Bugs

by tt-a1i

Diagnosing Bugs is a Quality skill for Claude Code, published by tt-a1i in matt-skills-with-to-goal.

29 stars7 forkson tt-a1i/matt-skills-with-to-goalAdded 2026/08/12+32% in starsRepository updated 2026/08/11

View source on GitHub Download repo ZIP

agent-skillsai-agentsclaude-codecodexcoding-agentsdeveloper-toolsworkflow

Install in seconds

Install Diagnosing Bugs

Copy Diagnosing Bugs into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/tt-a1i/matt-skills-with-to-goal/tree/main/skills/engineering/diagnosing-bugs ~/.claude/skills/diagnosing-bugs

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/tt-a1i/matt-skills-with-to-goal.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/engineering/diagnosing-bugs/SKILL.md in tt-a1i/matt-skills-with-to-goal
Installs to: ~/.claude/skills/diagnosing-bugs
Collection: One of 40 skills cataloged from this repository
Category: Quality — 1354 skills

What Diagnosing Bugs does

Diagnosing Bugs helps you build tight repro loops for hard bugs, failures, and performance regressions. Use it when debugging broken, throwing, failing, or slow behavior and you need to isolate the cause.

Diagnosing Bugs is cataloged under Quality on DirSkills. Diagnosing Bugs comes from a repository tagged agent-skills, ai-agents, claude-code, codex and coding-agents.

Documentation

README

Excerpt

Diagnosing Bugs

A discipline for hard bugs. Skip phases only when explicitly justified.

When exploring the codebase, read CONTEXT.md (if it exists) to get a clear mental model of the relevant modules, and check ADRs in the area you're touching.

Redact

This skill has you show commands, outputs and captured artifacts. Redact every secret first — write <REDACTED> in its place. Build loops against env vars, so the credential stays in the environment rather than in what you show. Captured artifacts carry auth headers: quote only the lines that carry the signal.

If the redacted output is not enough to diagnose the bug, say so and ask the user.

This is the opening of the README. Read the full README on GitHub.

Commands Diagnosing Bugs provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

/improve-codebase-architecture

Frequently asked about Diagnosing Bugs

What else does tt-a1i publish alongside Diagnosing Bugs?
Diagnosing Bugs is one of 40 skills that DirSkills catalogs from tt-a1i/matt-skills-with-to-goal, the repository it ships in. Its siblings there include Agent Handoff, Ask Matt and Ask Matt. Each one is a separate skill with its own page in this directory, installs the same way Diagnosing Bugs does, and is maintained by tt-a1i in that same repository. The rest of the collection is listed on the tt-a1i/matt-skills-with-to-goal page.
How does Diagnosing Bugs compare to other Quality skills?
Diagnosing Bugs ranks #1314 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Diagnosing Bugs against them. Open each page to compare what they document and how they install.