Explained Diff Review

Present completed changes as a reviewable conversation surface, not as a prose-only handoff. This review complements tests and any independent review required by the repository; it does not replace them.

This skill is shared by Claude Code and Codex from one directory. The review data, the build tool, and the widget template are identical on both hosts; only the way the widget is shown and the way its actions return to the conversation differ. Both hosts can also emit the same review as a standalone two-pane page when the inline width is not enough. See the host section below.

Required tooling

• Python 3 and git on PATH for scripts/review_tool.py, which captures the deterministic snapshot, extracts the contextual diff, validates and orders the review data, builds the widget, and verifies follow-up payloads.
• The fixed widget template assets/review-widget.html, and the document wrapper assets/review-page.html that --layout page puts around the same fragment. Never author widget HTML or JavaScript by hand; the template is the only executable code the screen contains. It styles itself from the host's theme tokens on both hosts and falls back to theme-aware defaults elsewhere.
• The host's inline visualization surface, described in the host section.

Read references/review-screen-contract.md for the data schema, commands, and interaction contract, and references/layer-order-and-impact-map.md for layer assignment, ordering, and the impact map before authoring the review data.

Host surfaces

Claude Code: