CtrlK
BlogDocsLog inGet started
Tessl Logo

hunt

Finds root cause before any fix. Use when something errors, crashes, regresses, or used to work. Not for code review or new features.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is hunt in tw93/Waza

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally actionable, well-structured diagnosis skill: concrete commands, hard validation gates, clear mode triggers, and a clean one-level reference split — all referenced files verified present. The only real cost is length; a few dense rule passages (regression-guard edge cases, reporter-environment probes) could be tightened or pushed to a reference file.

Suggestions

Move the regression-guard edge-case detail (shell bracket-form failures, negative-assertion pairing) into references/failure-patterns.md and keep a two-line rule with the link in SKILL.md.

Tighten the reporter-environment probe paragraph in the Runtime Evidence Ladder into a short checklist (what to print, what to omit, what to ask back) — it currently reads as one 100+ word run-on sentence.

The authorization boundary is stated twice in near-full form (Outcome Contract 'Authorization' bullet and Hard Rules 'Fix the cause within the authorized scope'); consolidate into one canonical statement with the other cross-referencing it.

DimensionReasoningScore

Conciseness

The body is dense with original project-specific rules and explains nothing Claude already knows (no 'what is git bisect' padding), but several passages are over-long and convoluted — the ~200-word regression-guard sub-rules covering shell bracket forms and negative assertions, and the reporter-environment probe paragraph. This is 'mostly efficient but could be tightened' rather than the minor-trimming of anchor 4.

3 / 5

Actionability

Guidance is fully executable for an instruction-only skill: concrete commands ("git status --short --branch -uall", "git diff <last-good>..HEAD -- <suspect path>", "grep -rn"), a fill-in hypothesis template ("I believe the root cause is [X] because [evidence]"), an exact output block, and a worked example of a testable hypothesis ("Stale cache in useUser at src/hooks/user.ts:42 because the dependency array is missing userId").

5 / 5

Workflow Clarity

The diagnostic workflow is clearly sequenced with explicit validation checkpoints and feedback loops: a numbered Runtime Evidence Ladder, hard-stop gates ("Same symptom after a fix is a hard stop"), confirm-or-discard with probe-driven re-orientation, and a red-green regression verification procedure. Bisect mode even sequences worktree safety checks before any bisect command.

5 / 5

Progressive Disclosure

The main file is an overview with mode-dispatch, and five specialized playbooks (durable-context, failure-patterns, ime-unicode, logging-techniques, rendering-debug) are one level deep, each referenced with an explicit activation trigger ("load references/logging-techniques.md before changing code"). All five referenced paths exist in references/, and nothing is nested deeper.

5 / 5

Total

18

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A tight, well-scoped description: explicit what/when, natural trigger terms, and explicit exclusions that prevent mis-dispatch. The only weakness is that it states a single core action rather than the several concrete diagnostic capabilities the skill provides.

DimensionReasoningScore

Specificity

"Finds root cause before any fix" names the diagnosis domain with one concrete action, but does not list several specific actions (e.g., bisect, targeted logging, sibling sweeps) that the skill actually performs. It fits anchor 3 rather than 4 because coverage of capabilities is thin in the description itself.

3 / 5

Completeness

The description explicitly answers both questions: what ("Finds root cause before any fix") and when ("Use when something errors, crashes, regresses, or used to work"), with concrete trigger phrases. It also adds negative scope ("Not for code review or new features"), which strengthens rather than weakens the explicit when-guidance.

5 / 5

Trigger Term Quality

"errors, crashes, regresses, or used to work" are natural phrases users would actually say, giving good keyword coverage. It misses a few common variations ("stack trace", "why broken", "not working") that only appear in the separate when_to_use field, so it is not anchor-5 comprehensive within the description text.

4 / 5

Distinctiveness Conflict Risk

The diagnose-before-fixing niche is distinct, and the explicit exclusions ("Not for code review or new features") sharply demarcate it from adjacent skills. Trigger terms like "regresses" and "used to work" point uniquely at regression diagnosis, matching the clear-niche anchor.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
tw93/Waza
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.