better-interface
Run a holistic interface review across accessibility, layout, writing, typography, color, and visual polish.
Install
npx skills add https://github.com/jakubkrehel/skills --skill better-interfaceReview output format
This is the format for a review better-interface orchestrates.
Scope and coverage
State the exact scope, stack and styling conventions, the project convention documents found in recon and any review boundary. Then show coverage:
Include every domain listed under Use domain skills as the sources of truth. Clear means inspected with no actionable finding; Not reviewed must explain why.
Findings
One table, ordered by severity, then by reach:
- Severity comes from Rank by user impact.
- Domain is the owning skill without the
better-prefix. - Location is
path/to/file:line, or the exact screen and component when the artifact has no source files. - Before and After show the current implementation and an actionable replacement, each in its own cell.
- Why names the violated principle and its user impact.
With no findings, omit the table and state "No actionable interface findings."
Verification
List each check or interaction, the exact command or steps and the observed result. Separate checks that passed from checks marked Not verified.
Verdict
End with one of two:
Block: one or moreHIGHfindings remain. Do not ship until they are fixed.Approve: noHIGHfindings remain. AnyMEDIUMandLOWfindings stay in the table as work to do.
Approve covers only the domains the coverage table shows as inspected. Name every Not reviewed domain in the verdict line.
Change-scoped reviews
When interface-review hands the review back, use its ## Review output format. It adds the scope block, a Status column and the pre-existing section to the sections above.