dvy1987/agent-loom / .agents/skills/design-review
design-review
VerifiedReview a built frontend against its chosen direction, catch drift back to generic AI defaults, enforce state coverage, ethical patterns, UX heuristics, and polish, and check contrast with APCA (not the legacy WCAG ratio). Produces specific, prioritized fixes — never vibes-based feedback. Works with pasted screenshots or Playwright MCP automated capture. Load when the user asks to review a UI, audit a design, check if a frontend looks generic or vibecoded, evaluate visual quality or polish, says "review this UI", "is this design good", "audit my frontend", "does this feel like [product]", "design QA", or when frontend-design routes here. Sub-skill of frontend-design.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.0 KB |
| references/apca-contrast.md | markdown | 2.0 KB |
| references/ethical-patterns.md | markdown | 1.7 KB |
| references/examples.md | markdown | 1.8 KB |
| references/playwright-flow.md | markdown | 3.1 KB |
| references/review-rubric.md | markdown | 5.8 KB |
| references/ux-heuristics.md | markdown | 1.8 KB |
| scripts/apca.mjs | script | 2.5 KB |
references/ux-heuristics.md
View on GitHub# UX Heuristics (supplement to visual rubric)
Lightweight usability checks beyond polish. Score as part of review; flag in findings
when any fail. No external link dependencies — patterns only.
## Navigation & wayfinding
- Current location is visible (breadcrumb, active nav, page title)
- Primary task reachable in ≤3 clicks from landing
- Back/exit paths exist on every modal and multi-step flow
- Destructive actions are not adjacent to primary actions without confirmation
## Forms & input
- Every field has a visible label (not placeholder-only)
- Required fields marked; optional fields marked when most are required
- Inline validation on blur or submit — not only on server round-trip
- Error messages name the field and the fix ("Email must include @")
- Password fields offer show/hide toggle
## Feedback & recovery
- Actions that take >400ms show loading state
- Success confirmations for irreversible or high-stakes actions
- Errors offer a recovery path (retry, edit, contact support) — not a dead end
- Empty states explain what belongs here and offer one next action
## Content & clarity
- Headings describe page purpose in plain language
- Jargon and abbreviations defined on first use (or avoided)
- Legal/consent copy is readable size; not buried in gray 10px text
- Pricing tiers compare features without hiding exclusions in footnotes
## Delight (micro-interactions + micro-copy)
- Transitions confirm causality (button press → result appears)
- Micro-copy matches product voice — not generic system strings
- One intentional delight moment per primary flow (not animation everywhere)
- `prefers-reduced-motion` honored (see accessibility gate)
## Scan method
Walk the three primary user flows from DIRECTION.md. For each screen, check the
sections above. Any clear fail → finding with `file:line` and specific fix.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |