visual-reviewlisted
Install: claude install-skill helderberto/agent-skills
# Visual Review
Turn a PR diff into an annotated HTML page you scan in a browser. Each finding sits next to its code and explains the **why** — the principle it touches and how to simplify — so you decide what to comment on the PR yourself. Read-only: this never posts to the PR or touches the branch.
Sibling of [`code-review`](../code-review/SKILL.md) (text feedback) and [`visual-validate`](../visual-validate/SKILL.md) (browser UI). Its edge is the visual artifact and the teaching: findings link to [`references/principles.md`](references/principles.md).
The lens covers design and simplification — readability and simplification, SOLID and design principles, testability, reusability, and maintainability: how to make each changed block clearer, more reusable, and easier to test. Bugs, security, and scope/claim mismatches (does the diff do what the PR description says?) stay out of scope — run [`code-review`](../code-review/SKILL.md) for those.
## Workflow
### Phase 1 — Resolve the PR
1. If a PR URL or number was passed as the argument, use it. Otherwise detect the PR for the current branch:
```bash
gh pr view --json number,title,author,url,baseRefName,headRefName
```
Completion: PR number, title, author, and URL are known. No PR and no argument → stop and ask for a URL or number.
### Phase 2 — Fetch the diff
2. Pull the unified diff and the file list, then read each changed file **at head** for full context — a hunk alone hides the surrounding code the findin