skills.by true||false
LibraryHow to run

A product of true||false

Every item lists its source, license and what we changed.

library
skilluitrueorfalse

ui-hig

Checks a screen against platform guidelines and the Laws of UX and names the specific rule each problem breaks.

looks for

  • a new screen or flow being designed
  • small or crowded tap targets
  • too many choices on one screen
  • non-standard navigation or controls
  • slow feedback after an action

outputs

  • → a findings list, each tied to a named rule (e.g. "Fitts — 28px target")
  • → concrete fixes (size, placement, grouping, state)
drawing flowchart…
flow.mmd

SKILL.md

UI: HIG, Material 3 and the Laws of UX

Use the platform's conventions unless you have a strong reason not to. Users spend most of their time in other apps (Jakob's law).

Laws of UX, as checks

LawWhat it meansCheck
FittsTime to hit a target grows with distance and shrinks with size.Primary actions big and near the thumb/cursor; destructive actions not next to frequent ones.
HickDecision time grows with the number of choices.≤ 1 primary action per view; group or progressively disclose the rest.
JakobUsers expect your app to work like others.Standard nav, icons, gestures and placement for the platform.
MillerWorking memory holds ~7±2 chunks.Chunk long numbers, group fields, keep menus short.
DohertyFeedback under ~400 ms keeps people in flow.Optimistic UI or a visible state change within 100–400 ms.
TeslerComplexity can't vanish, only move.Move it to the system (good defaults, auto-fill), not the user.
Aesthetic-usabilityPolished UI is perceived as easier.Not an excuse to skip usability fixes.
Von RestorffThe different thing is remembered.Only one thing is visually loud.
Proximity / common regionNear or enclosed = related.Spacing and cards express grouping.

Touch and pointer targets

PlatformMinimum
Apple HIG44×44 pt
Material 348×48 dp
Web (WCAG 2.2 AA 2.5.8)24×24 CSS px minimum, 44×44 recommended

Spacing between adjacent targets ≥ 8 px. Visual size may be smaller than the hit area.

Hierarchy

  • One clear title per screen; heading levels follow visual weight.
  • One filled primary button; secondary = tonal/outlined; tertiary = text.
  • Type scale from the design system only; ≤ 3 sizes per view is a good target.
  • Alignment on a grid; consistent left edges beat centred everything.

Platform conventions

  • Apple: tab bar ≤ 5 items for top-level sections; nav bar with back on the left; sheets for focused tasks; SF Symbols; respect safe areas and Dynamic Type.
  • Material 3: navigation bar (3–5 destinations) on compact, navigation rail on medium, drawer on expanded; FAB for the single main action; tonal surfaces for elevation; dynamic colour roles (primary, secondary, tertiary, surface, error).
  • Web: links look like links; the logo goes home; the back button works; URLs reflect state.

States every component needs

Default, hover (pointer), focus-visible, pressed/active, disabled, loading, error, empty, selected. A data view also needs loading → empty → error → data.

Copy

Sentence case. Buttons are verb + object ("Save changes"). Errors say what happened and what to do next. No "OK"/"Submit" when a specific verb exists.

Review output

One line per finding: where — rule — problem — fix. Example: Checkout footer — Fitts — "Pay" is a 28 px text link at top-left — make it a full-width 48 px primary button at the bottom.

Customize for your project

  • Target platforms: {{PLATFORMS}} (iOS, Android, web, desktop).
  • {{DESIGN_SYSTEM}} for tokens and components.

audit trail

source
original
author
trueorfalse.dev
license
MIT
imported
2026-11-13
verified
2026-11-13
changes
Written new for the catalog.
privacy scan
pass
scripts
none
in the zip
1 file

works with

Claude, Codex, ChatGPT

pairs with

  • skilltrueorfalse

    design-system

    Gives implementers a working checklist so every screen uses primitives and tokens instead of one-off styles.

    • raw hex colours, px spacing or font sizes in a component
    • a new UI library or icon set being added
    • a component duplicated across two screens
    Claude · Codex · ChatGPT
  • skilltrueorfalse

    accessibility

    Checks and fixes semantics, keyboard, focus, contrast, labels and motion against WCAG 2.2 AA.

    • div or span used as a button
    • custom controls (switch, tabs, menu, dialog, combobox)
    • icon-only buttons
    Claude · Codex · ChatGPT
  • skilltrueorfalse

    motion

    Sets the rules for presets, wrappers, reduced motion and performance so animation is consistent and 60 fps.

    • library animation calls scattered through pages
    • animating width, height, top, left or box-shadow
    • no prefers-reduced-motion handling
    Claude · Codex · ChatGPT
  • personatrueorfalse

    ui-ux-designer

    Reviews layout, colour, density and component boundaries and outputs a precise design brief; does not write production code.

    • a redesign request
    • generic "AI slop" UI (random gradients, glows, wasted whitespace)
    • inconsistent spacing or rogue colours
    Claude · Codex · ChatGPT
  • agenttrueorfalse

    ui-review

    Reviews only the changed lines of a UI diff and reports blocking vs. should-fix findings with quoted code and fixes.

    • a diff under pages, components or theme
    • hex colours, px values or font sizes added in a change
    • a new data surface without loading/empty/error states
    Claude · Codex · ChatGPT