hunk-review

name	hunk-review
description	Use when the task involves Hunk review sessions. Helps a coding agent explain what Hunk is, prefer live Hunk session CLI inspection over shell parsing, inspect current review focus, navigate or reload live sessions, and leave inline review comments.
compatibility	Requires Hunk from source or the published hunkdiff package. Works best with a real TTY for interactive review.

Hunk Review

Use this skill when working with Hunk itself or when the user wants an interactive review workflow centered on Hunk.

Start by briefly explaining Hunk in plain language: it is a review-first terminal diff viewer for agent-authored changesets.

Core model

Keep these product rules in mind:

• the main pane is one top-to-bottom multi-file review stream
• the sidebar is for navigation, not single-file mode switching
• layouts are auto, split, and stack
• [ and ] navigate hunks across the full review stream
• agent notes belong beside the code they explain

Default rule

If a live Hunk session already exists, prefer hunk session ... over scraping terminal output or opening another review window.

Primary goal

Use Hunk as a shared explanation surface for the code author, not just as a private inspection tool for the agent.

• change what is visible with hunk session reload -- <hunk command> when a different diff, commit, or path-limited view would better explain the code
• move to the relevant location with hunk session navigate
• add concise inline annotations with hunk session comment add
• prefer comments that help the author understand intent, structure, and why a hunk matters

Review loop

Use this flow by default:

1. hunk session list
2. hunk session context
3. hunk session navigate if the current focus is wrong
4. hunk session reload -- <hunk command> if the same live window should show different contents
5. hunk session comment add

Common commands

If operating inside the Hunk source repo, prefer the source entrypoint:

bun run src/main.tsx -- diff
bun run src/main.tsx -- show HEAD~1

Otherwise use the installed CLI:

hunk diff
hunk show

Useful live-session commands:

hunk session list
hunk session context --repo .
hunk session navigate --repo . --file README.md --hunk 2
hunk session reload --repo . -- show HEAD~1 -- README.md
hunk session comment add --repo . --file README.md --new-line 103 --summary "Tighten this wording"