hunt

hunt is a skill for Claude Code, Codex from tw93/Waza. It costs 70 tokens per session (4,147 once invoked), scanned A, original, MIT.

A troubleshooting workflow that identifies the underlying cause of errors, crashes, regressions, failing tests, broken behavior, and defects shown in screenshots before changes are made.

In plain words
What is it for?
Use it to investigate why software stopped working, trace a problem to a specific file or condition, and verify a fix or handoff with reproduction steps, logs, tests, builds, or runtime checks.
Why use it?
It helps prevent patches that hide a symptom while creating another bug. It also requires evidence that the cause explains the reported problem and that the result was checked.

Skill for Claude CodeCodex

About the project

Waza is a collection of installed skills that turn familiar engineering practices into repeatable playbooks for coding agents. It helps agents plan work, design interfaces, review changes, debug problems, edit prose, research unfamiliar subjects, read URLs or PDFs, and check their own health. The catalogue entries are Waza’s skills and supporting agents or instructions.

tw93/Waza · 6,958 stars · on GitHub · faberon.io

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.

agentmods
npx agentmods add skills/tw93/waza/hunt
Any agent
npx skills add tw93/Waza --skill hunt
Clone the repo
git clone --depth 1 https://github.com/tw93/Waza

Made for: Claude Code, Codex.

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 hunt

README.md
[![agentmods](https://agentmods.dev/badge/skills/tw93/waza/hunt.svg)](https://agentmods.dev/skills/tw93/waza/hunt)
Your own site
<a href="https://agentmods.dev/skills/tw93/waza/hunt"><img src="https://agentmods.dev/badge/skills/tw93/waza/hunt.svg" alt="Measured on agentmods" height="20"></a>
Per session 70 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,147 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00070 $0.04147
Opus 5 $0.00035 $0.02073
Sonnet 5 $0.00014 $0.00829
Haiku 4.5 $0.00007 $0.00415

Measured 2d ago against content hash 0a25c2742636, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

hunt 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 2d 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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

  • hunt — 91% identical, 65 lines differ
plugins/waza/skills/hunt/SKILL.md · 199 lines

How it starts

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

Hunt: Diagnose Before You Fix

Prefix your first line with 🥷 inline, not as its own paragraph.

A patch applied to a symptom creates a new bug somewhere else.

Outcome Contract

  • Outcome: the root cause is identified before any fix is applied.
  • Done when: one sentence explains the cause, every observed symptom fits it, and the fix or handoff is verified against a reproducible check.
  • Evidence: source trace, repro command or UI path, logs or state, targeted test/build output, and runtime evidence for UI or native defects.
  • Output: root cause, fix or handoff, verification result, and any unswept sibling risks.
  • Authorization: "diagnose", "investigate", "why", "look into", "排查", "看看", or equivalent is report-only. Apply a fix only when the current turn explicitly asks to fix, change, implement, or optimize; root-cause proof is still required first.

Do not touch code until you can state the root cause in one sentence:

"I believe the root cause is [X] because [evidence]."

Name a specific file, function, line, or condition. "A state management issue" is not testable. "Stale cache in useUser at src/hooks/user.ts:42 because the dependency array is missing userId" is testable. If you cannot be that specific, you do not have a hypothesis yet.

Diagnosis Signals

Hypothesis quality gate: the hypothesis must explain every observable symptom, not just the one reported first; partial coverage is a symptom-level guess, not a root cause. A symptom the reporter waves off as unrelated is still a symptom the hypothesis has to cover. For timing-dependent issues (flicker, intermittent failure, race), reproduce reliably before diagnosing.

Rationalization smells: "I'll just try this" = no hypothesis, write it first. "I'm confident" = run the instrument that proves it. "Probably the same issue" = re-read the execution path from scratch. "It works on my machine" = enumerate env differences before dismissing. "One more restart" = read the last error verbatim; never restart more than twice without new evidence.

Read the full file on GitHub · 199 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 2d ago Changed · -9 lines 0a25c2742636
  2. 6d ago First seen · 208 lines · 70 tokens per session scan A 1a7c08b09d08

Subscribe to this mod's changes

hunt is a skill published in the GitHub repository tw93/Waza (6,958 stars, last pushed 2d ago), licensed MIT. It adds 70 tokens to every session and 4,147 once invoked, about $0.0003 per session on Opus 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-30.