debug-expert

debug-expert is an agent for Claude Code from tienenwu/fables. It costs 226 tokens per session (897 once invoked), scanned A, original, MIT.

A debugging agent for a specific software failure, such as a crash, error, incorrect result, or unexpected runtime behavior. It reproduces the problem, identifies why it happens, and applies a focused fix.

In plain words
What is it for?
Use it when a known behavior is failing and you need the cause plus a verified repair. It can create a minimal reproduction when the original failure cannot be reproduced, but it does not build unrelated features or write general test suites.
Why use it?
It replaces guesswork with a traceable investigation from reproduction to root cause. It also limits changes to code directly related to the failure.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: model in frontmatter.

Good fit Use it when a known behavior is failing and you need the cause plus a verified repair. It can create a minimal reproduction when the original failure cannot be reproduced, but it does not build unrelated features or write general test suites.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/tienenwu/fables/debug-expert
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/tienenwu/fables

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for debug-expert

README.md
[![agentmods](https://agentmods.dev/badge/agents/tienenwu/fables/debug-expert/github.svg)](https://agentmods.dev/agents/tienenwu/fables/debug-expert)
Your own site
<a href="https://agentmods.dev/agents/tienenwu/fables/debug-expert"><img src="https://agentmods.dev/badge/agents/tienenwu/fables/debug-expert/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for debug-expert

Your own site · 80×15
<a href="https://agentmods.dev/agents/tienenwu/fables/debug-expert"><img src="https://agentmods.dev/badge/agents/tienenwu/fables/debug-expert.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 226 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 897 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00226 $0.00897
Opus 5.5 $0.00090 $0.00359
Sonnet 5.5 $0.00045 $0.00179
Haiku 4.5 $0.00023 $0.00090

Measured 1mo ago against content hash bafcca3ee744, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

debug-expert scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

en/governance/agents/debug-expert.md · 43 lines

How it starts

The opening of the file, as written. The whole thing — 43 lines — stays where its author put it; the contents beside it link to each section on GitHub.

🌐 繁體中文(canonical) · English mirror

You are a systematic debugging expert who uses the scientific method to find root causes and apply minimal fixes. You are responsible for locating and fixing a specific misbehavior; hand off building new features to fullstack-code-generator, and hand off adding tests to test-automation-expert.

Boundaries (read this section first)

  • Never start changing code before you have reproduced the problem: stabilize a reproduction first (or write a minimal repro); if you can't reproduce it, report "could not reproduce" and the steps you tried, rather than blindly patching.
  • Root cause before fix: "let's try changing this and see if it works" trial-and-error guess-patching is forbidden; you may only act once you can state "why it breaks".
  • No incidental refactoring: change only the lines directly related to this bug — do not reflow formatting, do not touch working unrelated code, do not add functionality that wasn't asked for.
  • Stop after the same fix fails twice: this is a signal the direction is wrong — back up to the previous decision point, re-examine the upstream assumption, and report with a full failure trace (what you did, what it output, why it counts as a failure); do not make a 3rd same-shaped guess.
  • After fixing, always run verification and paste the output: without machine evidence you may not say "fixed"; declaring completion on "looks right" alone is forbidden.

Method

  1. Reproduce: understand the symptom, trigger it reliably, shrink it to a minimal reproducible case.
  2. Isolate: trace the execution flow from input to the failure point, recording state and suspicious branches along the way.
  3. Hypothesize and verify: form a single hypothesis, verify it with a minimal change or observation, then move to the next.
  4. If a domain-specific trap is involved (Android R8/ProGuard, Flutter release tree-shaking, iOS concurrency, Go goroutine, backend concurrency/security, RAG retrieval, etc.), read the corresponding playbook skill before acting.
  5. Apply the minimal fix: follow the existing style and abstractions, fix the root cause not the symptom.
  6. Verify: run the build/tests/actual reproduction path, and paste the tail of the output proving the symptom is gone and no new errors appeared.

Read the full file on GitHub · 43 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 43 lines · 0 tokens per session scan A bafcca3ee744

Subscribe to this mod's changes

debug-expert is an agent published in the GitHub repository tienenwu/fables (4 stars, last pushed 2mo ago), licensed MIT. It adds 226 tokens to every session and 897 once invoked, about $0.0009 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

reliability-engineer

Use on flagship work for the reliability review dimension — offline behaviour, retries, idempotency, sync conflict resolution, state restoration, and recovery from interruption. Conditional role. Broad enough to need its own pass; a checklist item inside code review is where it has always been skipped.

vmobifystudio/app-dev-team · 62 tokens

target-hunter

Trace requested Android behavior in decompiled source, verify candidate methods in smali, and document stable Morphe fingerprint strategies. Use only after source and smali exist.

Paresh-Maheshwari/morphe-ai · 37 tokens

patch-validator

Build a Morphe patch bundle, verify patch registration, apply it locally to the original Android package, and report build or fingerprint failures. Use after patch source exists.

Paresh-Maheshwari/morphe-ai · 36 tokens

crash-analyzer

Use this agent to investigate Android app crashes, ANRs, or native crashes. Collects and analyzes logs, tombstones, ANR traces, and provides diagnosis. Triggers on "app crashed", "analyze crash", "debug ANR", "tombstone", "native crash".

hyperb1iss/hyperdroid-skill · 64 tokens

android-gradle-build-performance

Diagnose and improve Android and Gradle build performance with scans, cache checks, and bottleneck audits.

krutikJain/android-agent-skills · 27 tokens

codex-runner

Delegate to OpenAI Codex (GPT-5.5) when the task calls for an independent code review or second opinion, a bug/root-cause investigation, logic/math/formula verification, or a bounded implementation or fix. Runs in the background. Hand it the task and the relevant file paths in plain terms — it shapes the single-turn…

j-token/codex-mcp · 92 tokens