human-review

Presents AI-authored repository changes as evidence-backed before-and-after reviews for human judgment.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/hkw2028/toy-project --skill human-review-hkw2028
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: human-review
Source: https://github.com/hkw2028/toy-project/tree/main/.agents/skills/human-review
Command: npx skills add https://github.com/hkw2028/toy-project --skill human-review-hkw2028

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? When an AI agent completes a large implementation, the human reviewer cannot realistically read the entire diff, yet a plain summary hides consequential behavior changes, unverified claims, and open product decisions. This Skill turns completed AI work into an inspectable review grounded in actual results and evidence. ## Core Features & Use Cases - Behavior-centered explanation: Reconnects to the original request and explains each changed behavior with before/after results, mechanism, and consequences, organized by what happens rather than by file. - Evidence integrity: Distinguishes observed results, source-derived inferences, supplied evidence, and unverified claims, and never presents mocks or prior AI summaries as proof. - Decision routing: Surfaces at most three unresolved product decisions at a time, keeps confirmed defects separate as blockers, and records a resumable return point when review pauses. - Use Case: After an agent finishes a checkout change, generate a self-contained HTML review page showing actual before/after behavior, flagging a confirmed duplicate-charge defect as a release blocker, and listing only the product questions that genuinely need human judgment. ## Quick Start Ask the AI to use the human-review skill to walk you through the completed change with actual before-and-after results and evidence, highlighting only what needs your decision.

Frequently Asked Questions about human-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a large AI-generated PR without reading the whole diff?

Use this Skill to get a behavior-centered walkthrough of the change. It explains each changed behavior with before/after results, nearby evidence, and consequences, so you inspect actual outcomes instead of raw file diffs.

How does the review separate real evidence from AI claims?

Every result is labeled as directly observed, inferred from source, supplied by someone, or unverified. Prior AI summaries are treated as claims, and mocks or proposed screens are never presented as observed results.

Can I resume a human review after switching to another task?

Yes. The Skill records the source revision, what you examined, your expressed decisions, and open questions as a return note. On return it compares the current work against that recorded source before resuming.

When should I not use this human review skill?

Skip it for ordinary change summaries, trivial diffs like typo fixes, automated bug hunting, or non-repository content. It is designed for understanding consequential AI-authored work, not general code review or defect scanning.

Does the review HTML page prove the product change is correct?

No. Browser verification of the review page only confirms the review surface works. Product correctness depends on the underlying observed evidence, and confirmed defects are reported as blockers regardless of page rendering.