CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hunk-review

Interacts with live Hunk diff review sessions via CLI. Inspects review focus, navigates files, hunks, and exact lines, reloads session contents, adds inline review comments, and paints attention marks on character ranges. Use when the user has a Hunk session running or wants to review diffs interactively.

Quality

89%

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

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.

The body is a dense, highly actionable CLI reference with excellent error-recovery feedback loops and explicit workflows; it never wastes tokens on background concepts. Its main weakness is structural: the entire command syntax, STML details, and error catalog live inline in one long file with no reference files to defer detail to, and some guidance is duplicated across sections.

Suggestions

Split the detailed command syntax blocks and the 'Common errors' catalog into a references/ file (e.g., references/commands.md and references/errors.md), keeping SKILL.md to the workflow, session selection, and a quick-start subset of commands.

Remove the duplicated --source/--session-path guidance (present in both 'Session selection' and 'Reload') and consolidate the 'Workflow' and 'Typical flow' sequences into one.

Trim reminders that restate defaults Claude already follows (e.g., 'Quote --summary and --rationale defensively in the shell').

DimensionReasoningScore

Conciseness

Nearly every line carries tool-specific facts Claude cannot know (flag semantics, UTF-16 offset semantics, note visibility rules, error catalogs), and it assumes competence throughout — no padding explaining what diffs or CLIs are. Not 5: there is avoidable duplication — the `--source` guidance appears in both 'Session selection' and 'Reload', the workflow appears twice ('Workflow' and 'Typical flow'), and bullets like 'Quote `--summary` and `--rationale` defensively in the shell' state things Claude already does by default.

4 / 5

Actionability

Every section gives copy-paste-ready commands with concrete arguments — 'hunk session navigate --repo . --file src/App.tsx --new-line 372', the printf-batched 'comment apply --stdin' example, and 'highlight add ... --start 6 --end 19' — covering the common cases for each command family. Not 4: examples span inspect, navigate, reload, comments, highlights, and error recovery with executable syntax throughout, leaving no significant gaps.

5 / 5

Workflow Clarity

The numbered 'Workflow' and 'Guiding a review' sequences are explicit, and the 'Common errors' section provides genuine feedback loops (error string → diagnosis → corrective command), including validation of the batch before mutation ('validates the full batch before mutating the live session') and a confirmation gate for the destructive daemon restart ('ask before running `hunk daemon restart --yes`; never restart unprompted'). Not 4: checkpoints are explicit and recovery-oriented, not just implicit.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so everything — full CLI syntax blocks, STML markup details, and a long error catalog — is inlined in one ~220-line SKILL.md, which matches the anchor example of '[200 lines of API reference] that could be in a separate file'. Not 2: sections are well-organized with clear headers, not a wall of text; not 4: the detailed command reference and common-errors material would serve better in a one-level-deep reference file, which is a real organization gap rather than a minor one.

3 / 5

Total

17

/

20

Passed

Description

88%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 strong description: third-person, concrete, action-complete, with an explicit 'Use when' trigger clause tied to the named tool. The only weaknesses are a few missing natural trigger variations and slight overlap risk between 'review diffs interactively' and generic code-review requests.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Inspects review focus, navigates files, hunks, and exact lines, reloads session contents, adds inline review comments, and paints attention marks on character ranges' — giving comprehensive coverage of the skill's capabilities. Not below 5: coverage is broad and each action is specific rather than generic; nothing meaningful is missing from the body's scope.

5 / 5

Completeness

It explicitly answers both questions: 'what' via the enumerated concrete actions in the first two sentences, and 'when' via 'Use when the user has a Hunk session running or wants to review diffs interactively.' Both are explicit and concrete, matching the top anchor; not 4 because the 'when' clause is already specific and trigger-phrase-like rather than vague.

5 / 5

Trigger Term Quality

Good natural keywords — 'Hunk session', 'diff review', 'review diffs interactively' — that a user with this tool would plausibly say, and it stays in third person. Not 5: a few natural variations users might say are absent (e.g., 'code review', 'walk me through the changes/diff', 'untracked files'); not 3: the terms present are domain-appropriate and would be recognized, not generic.

4 / 5

Distinctiveness Conflict Risk

Tied to the distinct product name 'Hunk' with clear session-scoped triggers, so it is mostly distinct. Not 5: 'wants to review diffs interactively' could plausibly fire for generic diff/code-review requests that don't involve Hunk, creating minor overlap with general code-review skills; not 3: overlap is minor, not routine.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

modem-dev/hunk

Path

packages/hunk/skills/hunk-review/SKILL.md

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.