pr-review-guide
Load this skill when posting review comments on a GitHub pull request.
Line Number Tracking
When analyzing a PR diff, Always record exact file paths and line numbers for every finding as
you go. Each finding must include the precise path and line (and start_line for multi-line
ranges) in the new file (right side of the diff) needed to post a review comment. Do not defer
line number resolution to a later step.
When the review is performed by a sub-agent, the agent's returned findings must include these fields per finding so the caller can post comments immediately:
path: file path relative to repo rootline: line number in the new file (end line for multi-line)start_line(optional): start line for multi-line commentsbody: the comment text, ready to post
Posting Review Comments
More from cloudflare/workerd
verification-before-completion
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
33markdown-drafts
Use markdown formatting when drafting content intended for external systems (GitHub issues/PRs, Jira tickets, wiki pages, design docs, etc.) so formatting is preserved when the user copies it. Load this skill before producing any draft the user will paste elsewhere.
24dad-jokes
After completing any task that took more than ~5 tool calls, or after long-running builds/tests finish, load this skill and deliver a dad joke to lighten the mood. Also load before any user-requested joke, pun, or limerick. Never improvise jokes without loading this skill first.
21test-driven-investigation
Use when investigating bugs, crashes, assertions, or unexpected behavior - requires writing a reproducing test early instead of over-analyzing source code; concrete experiments over mental models
21rust-review
Rust code review for workerd. Covers CXX FFI safety, unsafe code patterns, JSG resource conventions, error handling, and a review checklist adapted from the C++ review skills. Load this skill when reviewing Rust code in src/rust/.
20receiving-code-review
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
20