visual-review

Installation
SKILL.md

Visual Review

Two modes. Diff mode (default) annotates a PR diff as HTML. UI mode (--ui [url]) checks a UI change in a real browser; see UI mode.

Diff mode

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 (text feedback). Its edge is the visual artifact and the teaching: findings link to 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 — /code-review covers those.

Workflow

Phase 1 — Resolve the PR

Installs
5
GitHub Stars
19
First Seen
Aug 23, 2026