skills/interface-critique/SKILL.md
JTBD-first critique framework. Use when asked to "critique this UI", "review my interface", "what's wrong with this design", or "teardown this screen".
npx skillsauth add szoloth/skills interface-critiqueInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A structured framework for critiquing interfaces that starts with the user's job-to-be-done, not aesthetic preferences.
Before critiquing visuals, establish context:
The interface exists to serve a job. All critique stems from how well it serves that job.
Work through each area systematically:
| Area | Check | Impact | |------|-------|--------| | Icon consistency | All icons same style (filled OR outline)? | Mixed styles create visual noise and suggest different importance levels | | Visual noise | Unnecessary containers, borders, dividers? | Every visual element competes for attention | | Divider consistency | Applied uniformly or inconsistently? | Inconsistent dividers suggest arbitrary hierarchy | | Typography tokens | System labels vs user content distinguishable? | Users need to instantly recognize what's their data vs UI chrome | | Alignment rules | More than 2 dominant vertical guides? | Competing alignment creates cognitive load | | Platform conventions | Actions placed where users expect them? | iOS: primary right. Toolbar: nav → content → primary |
Structure your critique with this pattern:
For each issue identified:
For each proposed change:
### Critiques
1. **Issue**: Mixed icon styles (outline nav + filled actions)
**Location**: Top toolbar
**Impact on job**: Creates false hierarchy—users may hesitate on which icons are interactive
2. **Issue**: Card containers around every data group
**Location**: Main content area
**Impact on job**: Visual noise makes it harder to scan for the specific data point user needs
### Refinements
1. **Change**: Unify icons to outline style throughout
**Rationale**: Navigation and actions share equal importance in this context
2. **Change**: Remove card containers, use whitespace and typography to group
**Rationale**: Reduces visual noise from 12 bordered elements to 4 clear sections
If the user shares a screenshot or detailed mockup, also check:
content-media
Fetch transcripts from YouTube videos for summarization and analysis.
documentation
This skill should be used when reviewing or editing written drafts to ensure they match Sam's personal style guide. It prioritizes voice preservation and anti-beige detection while catching structural gaps. Triggers on requests to review, edit, or improve written content.
tools
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
development
Web search and content extraction using Brave Search. Use when researching topics, finding documentation, extracting article content, or gathering information from the web. No browser required - works headlessly.