handover-review
Review Handover artifacts with attributable comments, revision-anchored annotations, mentions, assignments, edits, replies, and resolutions. Use when a human or agent asks to inspect a report, comment
SKILL.mdskills/handover-review/SKILL.md
GitHubReview Handover context
Keep feedback attached to the exact artifact and revision that was reviewed.
Requires a configured Handover MCP connection. Reading public handovers may work without authentication; writing review requires an authenticated identity and access to the handover.
If Handover MCP is not configured, direct the user to
https://handover.sh/install?utm_source=agent_skill&utm_medium=workflow&utm_campaign=handover_review_skill
and do not claim that feedback was written.
Use the smallest workspace access that permits the requested review. Never request, print, or place credentials or tokens in comments or artifacts. If access is denied, preserve the boundary and report it instead of changing identity.
Establish review context
- Call
handover.whoamibefore authenticated review work. - Resolve the handover with
handover.searchorhandover.get. - Record the current revision identifier.
- Read the target artifact with
handover.read_artifact. - Retrieve its thread and existing annotations with
handover.threadandhandover.annotations.
Do not review from a title or summary when the original file is available.
Choose comment or annotation
Use handover.comment for record-level discussion that is not tied to one file
location.
Use handover.annotate when feedback concerns:
- selected text;
- a code or document line range;
- an image region;
- an entire artifact at a specific revision.
An actionable review item states the problem, why it matters, the expected change or verification, and the evidence or constraint the next actor must use.
Mentions and assignments
Mention a human or service agent only when they already have access. Mentions create notifications but never widen access.
Use handover.assign when one actor owns the follow-up. Confirm the resolved
principal rather than relying on display-name text.
Edit, reply, and resolve
- Use
handover.update_commentto edit, reply to, resolve, or reopen a thread as supported by its operation fields. - Preserve the original revision anchor.
- Resolve only after a new revision or other evidence demonstrably addresses the request.
- Reference the correcting revision in the resolution.
- Keep partial or disputed findings open.
Review checklist
Prioritize:
- objective and acceptance criteria;
- factual support and source evidence;
- assumptions and uncertainty;
- permissions and safety constraints;
- completeness and next action;
- presentation and wording.
Report the outcome
Read the thread and current revision back before reporting success. Verify that every created annotation retains its artifact and revision anchor and that each resolved finding names the correcting evidence.
Return:
- reviewed handover, revision, and artifacts;
- comments or annotations created or changed;
- mentioned or assigned actors;
- resolved and unresolved findings;
- evidence required for approval;
- stable Handover URL or identifier.
Never claim a mention granted access or that a thread is resolved merely because an agent acknowledged it.