interface-review

Reviews git diffs and pull requests for interface regressions across UI, accessibility, typography, and layout.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/AO-HyS/aohys.com --skill interface-review-ao-hys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: interface-review
Source: https://github.com/AO-HyS/aohys.com/tree/main/.agents/skills/interface-review
Command: npx skills add https://github.com/AO-HyS/aohys.com --skill interface-review-ao-hys

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Code changes often introduce subtle interface regressions—removed ARIA labels, dropped focus styles, missing component states—that standard code review misses. This Skill reviews a change (branch, PR, or working tree) rather than a static screen, classifying every finding as Introduced, Regression, or Pre-existing so authors know exactly what their change caused. ## Core Features & Use Cases - Scope Resolution: Accepts targets like pr 482, branch, working, staged, or explicit ranges, resolving them against the merge base and excluding lockfiles, snapshots, and generated output. - Blast Radius Expansion: Expands changed files to the surfaces that render them (one hop, two for design tokens), reviewing up to five consumers with a stated cutoff. - Removed-Signal Detection: Reads the - side of every hunk to catch removed accessibility attributes, focus indicators, motion preferences, and text signals, routing each to the owning domain skill. - Use Case: Before merging a pull request that refactors a shared Button component, run the review to confirm no consumer lost its focus ring, accessible name, or disabled state, and receive a severity-ranked findings table with a Block or Approve verdict. ## Quick Start Ask the assistant to run an interface review on pull request 482 and report any introduced or regressed findings.

Frequently Asked Questions about interface-review

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

FAQPage Schema
How do I review a pull request for UI regressions?▼

Invoke the review with a target like `pr 482`. The skill fetches the PR head ref without checking it out, diffs it against the merge base, expands changed files to their consuming surfaces, and reports findings with Introduced, Regression, or Pre-existing status.

How to detect removed accessibility attributes in a git diff?▼

Search the deleted side of the diff with `git diff -U0` piped through grep for patterns like aria-, role=, alt=, focus, and tabindex. Each removal is a lead, not a finding—confirm nothing in the change replaces it before reporting a regression.

What happens when there is no change to review?▼

The skill never falls back to reviewing the last commit on its own. It reports repository facts—current branch, last commit SHA and subject, any open PR—then offers the last commit, a named target, or a whole-repository audit and waits.

Does the review modify my working tree or checkout branches?▼

No. The review is strictly read-only. It fetches pull request refs into remote-tracking refs and reads files with `git show`, never running checkout, switch, or stash. Rendered verification uses an isolated temporary worktree only when requested.

Which files are excluded from the interface review scope?▼

Lockfiles, snapshots, generated output, vendored code, and binaries are excluded and named in the scope block. Font files and images added to components stay in scope because they affect typography, alt text, and accessibility.

What are the limitations of a diff-based interface review?▼

Visual and runtime claims are marked Not verified unless a cheap preview exists or a rendered review is requested. Correctness, tests, security, and performance concerns are named once and deferred to the project's general code review.