interface-review
Reviews a branch, pull request or uncommitted change for the interface problems it introduced or regressed, across accessibility, layout, writing, typography, color and UI.
Install / Use
npx skills add jakubkrehel/skills --skill interface-reviewInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of interface-review
interface-review scores 91/100 on our quality scale, 342nd of 1,155 Content & Media skills we index (top 30%).
Its SKILL.md is 10 KB long, well organised into 13 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
With 7,131 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so interface-review is actively maintained.
- Our last check on 2026-10-28 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-28. Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
interface-review compared with similar skills
All 4 of these similar skills score higher than interface-review; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| interface-review (this skill)by jakubkrehel | 91 | 7.1k | 3mo ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install interface-review?
- Run
npx skills add jakubkrehel/skills --skill interface-review. The install tabs above show the steps for each supported agent. - Which AI agents does interface-review work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is interface-review safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is interface-review still maintained?
- The repository was last updated about 3 months ago, so interface-review is actively maintained.
Skill content
View source on GitHubname: interface-review disable-model-invocation: true description: Reviews your work across multiple categories like UI, typography, layout, color, writing and accessibility and gives you a detailed analysis of the findings.
Change review
This skill reviews a change rather than a screen. It resolves the scope, expands the changed files to the surfaces they affect, reads both sides of the diff and classifies every finding.
Scope is all it owns. Domain rules belong to the better-* skills. Severity, consolidation, coverage, the cap and the verdict belong to better-interface, which this skill hands the review to.
Correctness, tests, security and performance belong to the project's general code review. Name the concern once and move on.
The change, not the codebase
The author is asking "did I make this worse?". Report what the change caused and stay mostly quiet about what it merely touched. Three pre-existing findings is a courtesy; thirty is a different review and one nobody asked for.
Read the change before forming an opinion of it. The stated intent decides what counts as incomplete, and a skimmed diff produces findings about code the next hunk already fixed.
Core principles
1. Resolve the change scope first
The whole invocation is the target, so /interface-review pr 482 reviews pull request 482. Scope resolution holds the accepted targets and how each resolves.
With no target supplied, resolve in this order and stop at the first match:
HEADis ahead ofgit merge-base origin/<default-branch> HEAD: that range plus any uncommitted changes, with the commit count and the uncommitted file count stated separately.- The working tree is dirty: the uncommitted changes.
- Neither: there is no change to review. Stop and ask, per With no change, ask rather than invent one.
Order matters. Check the working tree first and one stray formatting edit shadows a twelve-commit branch, with the report still claiming full coverage.
Exclude lockfiles, snapshots, generated output, vendored code and binaries, and name what you excluded. An empty scope after exclusions reaches the same place by a different route.
2. With no change, ask rather than invent one
A clean tree with nothing ahead of the merge base means the user asked to review a change that does not exist. Never fall back to HEAD~1..HEAD on your own. The last commit is whatever happened to land, often a merge, often someone else's work, and a report on it is indistinguishable from a report on what the user meant.
State the repository facts you found, then offer the routes and wait. Nothing to review holds the facts to gather:
- The last commit,
HEAD~1..HEAD, named by short SHA and subject, so the user sees what they would get before choosing it. - A target they name:
pr <n>, a branch, a ref, or a range, resolved per Resolve the change scope first. - A whole-repository interface audit, which is not a change review. Hand it to
better-interfaceas a repository-scope review, without this skill's scope block, statuses, or pre-existing section. With no change, every finding is pre-existing and the classification says nothing.
Check for an open pull request on the current branch before asking, and offer it first. A branch whose commits already landed resolves to no change, while its pull request is still exactly what the user meant.
Where the scope emptied out after exclusions, say which files were excluded and ask the same way. Never report a review of nothing as Approve.
3. A diff is not a surface
A changed file is evidence, not the review subject. Its blast radius is the set of surfaces it renders in; review those.
Expand the blast radius one hop by default: the direct importers and callers. Expand a second hop only for design tokens, theme values and shared primitives, where one line reaches the whole product.
Review at most five consumers, ordered by the rule in Scope resolution, then state how many you did not expand. A sweep with no bound cannot support the coverage it claims, and an unstated cutoff reads as completeness.
4. Read the removed lines
Regressions are invisible in the post-change state. Read the - side of every hunk against Removed signals.
A signal is a lead, not a finding. A removal is only a regression when nothing in the change replaces it, and the domain skill owns that judgement. Route each unmatched removal to its owner, report only what that skill confirms and status it Regression. That tells the author they broke something that worked rather than made a new mistake.
5. Classify every finding
Give every finding one status:
Introduced: the change created it.Regression: the change weakened something previously correct.Pre-existing: present in the touched code but not caused by this change.
Status by what the diff touched, not by which file it sits in: a line the change never touched is Pre-existing even three lines from a hunk. Confirm against the base ref when it matters:
git blame -L <line>,<line> "$BASE" -- path/to/file
Hand every finding up with its status attached and let better-interface apply its cap and verdict rules.
6. Hold the change to its stated intent
Read the pull request title and body, the linked issue and the commit messages, then review whether the interface delivers what they claim.
This is what surfaces the incomplete change. A surface review cannot see it, because it inspects the states that are present, and here the point is the ones that are absent:
- A new variant, size, or theme applied to some states but not all: hover, focus, active, disabled, loading, selected.
- A new user-facing string with no entry in the translation catalogue the project maintains.
- A new component with no empty, loading, error, disabled, or narrow-width state.
- A control added to one surface but not to the siblings that already carry its peers.
Do not report scope creep. Whether a change does too much is a process question, not an interface one.
7. Hand the review to better-interface
Hand better-interface the scope block, the affected surfaces and a status on every finding. It routes to the domain skills, applies severity, consolidates, enforces the cap and issues the verdict.
If better-interface is unavailable, report the resolved scope and the file inventory, name it as the missing skill and stop. Do not invent a severity scale, a cap, or a verdict.
8. Never mutate the working tree
A change review is read-only, including the checkout. Fetch pull request refs; never check them out. git fetch writes only to .git and is permitted. gh pr checkout, git checkout, git switch and git stash rewrite the files the author has open. They fail against local edits or discard them, so they are never permitted.
Rendered verification is opt-in. Mark visual and runtime claims Not verified unless the project exposes a cheap preview or the user asks for a rendered review. When they do, use an isolated worktree (git worktree add /tmp/review-<n> refs/remotes/pr/<n>) and remove it when done.
Before you finish
| Mistake | Fix |
| --- | --- |
| One stray edit reviewed instead of the branch | Check merge-base before the working tree, and report both counts |
| The last commit reviewed because there was no change | State the facts and offer the last commit, a named target, or a repository audit |
| Hunks reviewed without their consumers | Expand one hop, two for tokens and primitives, and name what you skipped |
| Only the + side of the diff read | Search the - side for removed accessibility, focus, motion and text signals |
| An equivalent replacement reported as a regression | Route the removal to its owner; report only what it confirms |
| A removal reported as a new mistake | Status it Regression so the author knows it used to work |
| A line near a hunk statused Introduced | Status by what the diff touched, confirmed with git blame against the base ref |
| A pull request checked out to review it | Fetch the ref and review it in place |
| Line numbers cited that do not exist on the reviewed ref | Cite against the head ref named in the scope block |
| The severity scale or the finding cap restated here | Defer to better-interface |
| Correctness, test, or security findings in the report | Name the concern once, point at the project's code review and drop it |
Review output format
Open with the scope block:
| Field | Value |
| --- | --- |
| Target | branch, working, staged, pr 482, or the range as entered |
| Base ref | origin/main at a1b2c3d |
| Head ref | refs/remotes/pr/482 at e4f5g6h |
| Commits | 7 committed, 2 files uncommitted |
| Files in scope | 12 after exclusions |
| Excluded | pnpm-lock.yaml, src/__snapshots__/: lockfile and snapshots |
| Surfaces expanded | CheckoutPage, SettingsPanel; 3 further Button consumers not expanded |
The coverage table follows it unchanged. A domain with no evidence in the change scope is Not reviewed: no evidence in the change scope, which is a coverage statement rather than a gap.
Then the findings, with a Status column per Classify every finding:
| Severity | Domain | Status | Location | Before | After | Why |
| --- | --- | --- | --- | --- | --- | --- |
| HIGH | Accessibility | Regression | src/Dialog.tsx:42 | aria-label="Close" removed in this change | Restore aria-label="Close" on the icon-only control | The close control had an accessible name before this change and no longer does |
With no Introduced or Regression findings, omit the table and state "No actionable interface findings in this change."
Then Pre-existing findings, at most three, highest severity first, stated plainly as not this change's responsibility. Omit the section when there are none.
| Severity | Domain | Location | Issue |
| --- | --- | --- | --- |
| MEDIUM | Typography | src/Toolbar.tsx:7 | Numeric badges use proportional figures; predates this change |
The cap and the verdict cover Introduced and Regression only. Pre-existing findings sit outside the cap, so touching a legacy file cannot turn into a full-file audit. They sit outside the verdict too, so a change whose only findings are pre-existing is an Approve.
End with Block when any HIGH remains and Approve otherwise, leaving the remaining findings in the table as work to do. When better-interface is available, the severity scale and the cap come from it.
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
