Rewrite hunk-review skill following agent skill best practices#103
Merged
benvinegar merged 2 commits intomainfrom Mar 24, 2026
Merged
Rewrite hunk-review skill following agent skill best practices#103benvinegar merged 2 commits intomainfrom
benvinegar merged 2 commits intomainfrom
Conversation
- Add explicit warning that agents should NOT invoke hunk diff/show directly - Clarify hunk session * commands are for agent use - Separate user-facing interactive commands from agent-friendly session commands - Update 'when no session exists' to instruct suggesting user launch it
- Reduce from 177 to 108 lines (39% smaller) - Remove redundant explanations stated multiple times - Remove UI layout details agents cannot interact with - Remove comment style guidance agents already know - Add missing commands: comment clear, hunk session get, --json flags - Add workflow guidance for guiding reviews - Use third-person description in frontmatter - Remove non-standard frontmatter compatibility field - Group commands by purpose: Inspect/Navigate/Reload/Comments
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Complete rewrite of the hunk-review skill to follow best practices from platform.claude.com skill authoring guide.
Changes
comment clear,hunk session get,--jsonflags, session auto-resolutionKey principles applied
The skill now explains that the agent's role is to narrate: steer the user's view to what matters and leave comments that explain what they're looking at.