UI Enhancer Radar
<ui-enhancer-radar>Quick Ref: Screenshot + code analysis of any iOS/SwiftUI view. Design intent interview (sacred elements, aggressiveness), 13-domain analysis with layout reorganization, Color Audit (adaptive Color Profile), iPad Sheet Sizing caller-side audit, and Button Hit Region three-factor audit, element compaction (compact vs remove vs keep), cross-view consistency checks, design-aware refinement with push-back and App Store guardrails, incremental apply with revert safety (git or file backup), visual verification guidance, and files-changed summary.
You are performing a systematic UI enhancement on a specific iOS/SwiftUI view, analyzing both the visual screenshot and the underlying code, then implementing improvements with tests.
Required output: Every finding MUST include a severity rating (Critical / High / Medium / Low) and estimated implementation effort (Trivial / Small / Medium / Large).
Quick Commands
| Command | Description |
|---|---|
/ui-enhancer-radar | Full audit with interview |
/ui-enhancer-radar space | Space efficiency analysis only |
/ui-enhancer-radar hierarchy | Visual hierarchy analysis only |
/ui-enhancer-radar density | Information density analysis only |
/ui-enhancer-radar interaction | Interaction patterns analysis only |
/ui-enhancer-radar accessibility | Accessibility audit only |
/ui-enhancer-radar hig | HIG compliance check only |
/ui-enhancer-radar dark-mode | Dark mode audit only |
/ui-enhancer-radar performance | Performance impact analysis only |
/ui-enhancer-radar design-system | Design system compliance only |
/ui-enhancer-radar color | Color audit only (inventory, flatness, consistency) |
/ui-enhancer-radar ipad-sheets | iPad sheet sizing audit only (caller-side .sheet() check) |
/ui-enhancer-radar hit-region | Button hit region audit only (three-factor: .plain + Form/List + trailing chevron) |
/ui-enhancer-radar compare | Compare before/after screenshots for progress |
/ui-enhancer-radar revert | Undo all changes back to last checkpoint |
/ui-enhancer-radar batch [path] | Audit all views in a directory, rank by severity |
--show-suppressed | Show findings suppressed by known-intentional entries |
--accept-intentional | Mark current finding as known-intentional (not a bug) |
/ui-enhancer-radar --capture | Capture screenshot from running simulator (optional) |
/ui-enhancer-radar --devices | Analyze layout across device sizes (optional) |
/ui-enhancer-radar fix-deferred | Resolve items deferred from a previous run |
/ui-enhancer-radar verify | Re-check previous findings without full re-audit (~5 min) |
Help Command
If the user runs /ui-enhancer-radar help, display this command reference and stop (do not start an audit):
UI Enhancer — Available Commands
FULL AUDIT
/ui-enhancer-radar Full 13-domain audit with interview
SINGLE DOMAIN (skip interview, run one domain)
/ui-enhancer-radar space Space efficiency analysis
/ui-enhancer-radar hierarchy Visual hierarchy analysis
/ui-enhancer-radar density Information density analysis
/ui-enhancer-radar interaction Interaction patterns analysis
/ui-enhancer-radar accessibility Accessibility audit
/ui-enhancer-radar hig HIG compliance check
/ui-enhancer-radar dark-mode Dark mode audit
/ui-enhancer-radar performance Performance impact analysis
/ui-enhancer-radar design-system Design system compliance
/ui-enhancer-radar color Color audit (inventory, flatness, consistency)
/ui-enhancer-radar ipad-sheets iPad sheet sizing audit (caller-side `.sheet()` check)
/ui-enhancer-radar hit-region Button hit region audit (.plain + chevron + Form/List)
UTILITIES
/ui-enhancer-radar compare Compare before/after screenshots
/ui-enhancer-radar revert Undo all changes back to checkpoint
/ui-enhancer-radar batch [path] Audit all views in a directory
/ui-enhancer-radar help Show this command list
OPTIONS (combine with any command)
--capture Capture screenshot from running simulator
--devices Analyze layout across device sizes
First-Run Hint
When /ui-enhancer-radar is invoked with no subcommand, display this hint once before the Phase 1 interview (not on subsequent runs in the same session):
Tip: Run
/ui-enhancer-radar helpto see all available commands, or continue for a full audit.
Then proceed directly to Phase 1.
Skill Introduction (MANDATORY — run before anything else)
This section replaces radar-suite-core.md § Session Setup for the ui-enhancer-radar entry point. Do NOT also run core's 4-question Session Setup — its questions are consolidated below. Phase 1 ("Interview") below reuses the answers captured here and does NOT re-ask experience level, fix mode, or attendance.
On first invocation, ask all setup questions in a single AskUserQuestion call:
Question 1: "What's your experience level with Swift/SwiftUI?"
- Beginner — New to Swift. Plain language, analogies, define terms on first use.
- Intermediate — Comfortable with SwiftUI basics. Standard terms, explain non-obvious patterns.
- Experienced (Recommended) — Fluent with SwiftUI. Concise findings, no definitions.
- Senior/Expert — Deep expertise. Terse, file:line only, skip explanations.
Question 2: "How should fixes be handled?"
- Auto-fix safe items (Recommended) — Apply isolated, low-blast-radius fixes automatically. Present cross-cutting fixes and design decisions for approval first.
- Review first — Present all findings with ratings, then ask before making any changes. Fixes still happen — you just approve each wave first.
- Batch mode — Approve all fixes in each wave at once.
IMPORTANT: All three modes lead to fixes. "Review first" means the user sees the plan before code changes — it does NOT mean "skip fixes and jump to handoff." After presenting findings, ALWAYS offer to fix them regardless of which mode was selected. (Exception: Hands-Free mode overrides this — see Question 3.)
Question 3: "Will you be stepping away during the audit?"
- I'll be here (Recommended) — Normal mode. Permission prompts may appear for writes/edits.
- Hands-Free (walk away safe) — Read-only analysis only (Read, Grep, Glob). No edits, no Bash, no prompts. Hands-Free overrides Question 2: all fixes are deferred regardless of
FIX_MODE. Phase 7b (Visual Inspection Gate) is skipped — no code changes will be applied. The skill emits the saved playbook and Hands-Free completion message instead of the next-phaseAskUserQuestion(see § Hands-Free Mode below for full precedence rules). - Pre-Approved — You have already configured Claude Code permissions for this session. Run at full speed without restriction.
Store as: USER_EXPERIENCE, FIX_MODE, PRESENCE_MODE. Apply to ALL output for the session, per radar-suite-core.md § Experience-Level Output Rules. Also persist to .radar-suite/session-prefs.yaml per radar-suite-core.md § Session Persistence.
Question 4 (optional follow-up): "Would you like a brief explanation of what this skill does?"
- No, let's go (Recommended) — Skip explanation, proceed to Phase 1 (Interview).
- Yes, explain it — Show one of the explanations below adapted to experience level, then proceed.
Experience-adapted explanations for UI Enhancer:
-
Beginner: "UI Enhancer is like having a professional designer review every screen in your app. It checks 13 different things — spacing, colors, accessibility, layout efficiency, iPad sheet sizing, button hit regions, and more — then suggests specific improvements. It won't just say 'this looks wrong'; it'll show you exactly what to change and why. It works one view at a time, applying changes incrementally so you can undo anything."
-
**Interm