2001105254-netizen/RacePulsePH / .agents/skills/iso-ui-layout-auditor
iso-ui-layout-auditor
VerifiedCritique, audit, and refactor web and mobile UI screenshots or React/Tailwind code into high-density, zero-waste layouts governed by ISO ergonomics standards with separate Desktop (100vh) and Mobile (100dvh) checklists and blueprints. Use when auditing or refactoring consoles, dashboards, or field-staff views.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.0 KB |
| references/desktop-mobile-blueprints.md | markdown | 20.7 KB |
| references/iso-11064-4.md | markdown | 3.5 KB |
| references/iso-11064-5.md | markdown | 3.8 KB |
| references/iso-9241-110.md | markdown | 4.2 KB |
| references/iso-9241-112.md | markdown | 3.7 KB |
| references/iso-9241-115.md | markdown | 4.1 KB |
| references/iso-9241-125.md | markdown | 4.2 KB |
| references/iso-9241-161.md | markdown | 3.9 KB |
| references/iso-9241-920.md | markdown | 3.8 KB |
| references/iso-iec-11581-10.md | markdown | 3.4 KB |
| references/iso-iec-25010.md | markdown | 3.6 KB |
references/iso-iec-11581-10.md
View on GitHub# ISO/IEC 11581-10: User Interface Icons (Framework & General Guidance)
## Standard Identity & Scope
- **Designation:** ISO/IEC 11581-10 (Information technology, User interface icons, Part 10: Framework and general guidance).
- **Scope:** Framework and design guidance for user interface icons covering symbol discriminability, semantic mapping, consistency, and preventing icon ambiguity across applications.
## Core Principles Audited by This Skill
1. **Zero duplicate icons across distinct navigation modules:** Every distinct navigation destination or operational tool must carry a unique, semantically distinct icon (or text-only tab) so users never confuse modules by scanning glyphs.
2. **Mandatory text labels or accessible tooltips:** Never ship unlabeled, mystery-meat icon buttons in consoles or mobile toolbars; attach visible concise text labels wherever space allows, and always include `aria-label` plus accessible tooltip/title on icon-only controls (`R-39`).
3. **Semantic relevance over decorative trend icons:** Reject generic placeholder glyphs (Sparkle, Magic, Robot, decorative lightning bolts) in favor of symbols directly matching the domain operation (`QrCode`, `Timer`, `Wifi`, `CheckCircle2`, `Ban` per `R-04`).
4. **Visual balance & consistent stroke weight:** Icons paired with text must stay aligned to the baseline (`inline-flex items-center gap-2`) and carry `aria-hidden="true"` when decorative alongside a visible label (`R-39`).
## Desktop Console Criteria (`1080p` / `1366x768`, `100vh`)
- **Sidebar & toolbar icon uniqueness:** Audit all icons in `DesktopSidebar.tsx`, workspace tabs, and right-dock headers to verify zero glyph reuse across distinct destinations (`Timing`, `Events`, `Broadcast`, `Access`, `Bib Studio`).
- **Label + icon pairing:** Sidebar items and primary toolbar CTAs always render icon + text label (`1` to `2` words) plus optional shortcut badge; icon-only compact controls (`Refresh`, `Fullscreen`, `Close`) must declare `aria-label` and `title`.
## Mobile Field-Staff Criteria (`390x844`, `100dvh`)
- **Labeled bottom navigation & action dock:** Every item in the mobile `BottomNav` or bottom action bar displays both a distinct icon and a short text label (`>= 11px-12px` readable label), never raw unlabeled icons.
- **No duplicate icons across bottom tabs and row actions:** Ensure row quick-actions (e.g., `Edit`, `Assign Chip`, `Verify`) use icons distinct from primary tab navigation icons.
## React & Tailwind Audit Patterns
```tsx
// Compliant labeled action button and accessible icon-only utility button
<button type="button" onClick={onScan} className="min-h-11 px-3 inline-flex items-center gap-2 rounded-lg bg-red-600 text-white text-sm font-semibold">
<QrCode className="w-4 h-4 shrink-0" aria-hidden="true" />
<span>Scan Bib QR</span>
</button>
<button
type="button"
onClick={onRefresh}
aria-label="Refresh timing feed"
title="Refresh timing feed (F3)"
className="min-h-11 min-w-11 inline-flex items-center justify-center rounded-lg border border-[var(--border-default)]"
>
<RefreshCw className="w-4 h-4" aria-hidden="true" />
</button>
```
## Inspection Evidence
- List every navigation module and toolbar button in the audited UI with its icon component name; confirm zero duplicate icon components map to different actions/modules.
- Confirm every icon-only `<button>` has a non-empty `aria-label` and accessible tooltip/title, and every icon paired with text sets `aria-hidden="true"` (`R-39`).
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 |