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-11064-5.md
View on GitHub# ISO 11064-5: Ergonomic Design of Control Centres (Displays & Controls)
## Standard Identity & Scope
- **Designation:** ISO 11064-5 (Ergonomic design of control centres, Part 5: Displays and controls).
- **Scope:** Design and co-location of visual displays (screens, indicator lamps, mimic readouts, alarms) and operator controls (buttons, triggers, hardware inputs) to maximize safety, speed, and error-free human-system operation.
## Core Principles Audited by This Skill
1. **Co-location of controls and displays:** Keep hardware/scanner triggers, chip assignment inputs, and state-transition controls directly alongside the live feed they affect rather than splitting them across separate pages or tabs.
2. **Strict separation of read-only telemetry vs editable controls:** Operators must distinguish passive status displays (`LAN Connected`, `Elapsed Clock`, `Finisher Count`, `Offline Queue`) from mutable configuration inputs (`Gun Start Override`, `Reader Port`, `Penalty Seconds`) at a glance.
3. **Clear alarm & connectivity priority:** Degraded states (`LAN Offline`, `Pending Offline Queue > 0`, `Duplicate Read`) must surface as persistent, unmistakable visual status cues without blocking active local controls (`R-27`).
4. **Low-latency trigger mapping:** High-frequency operational actions use direct single-click buttons or hardware F-key bindings rather than multi-step dropdowns.
## Desktop Console Criteria (`1080p` / `1366x768`, `100vh`)
- **Telemetry ribbon boundary (`<= 40px`):** Keep the top telemetry strip strictly read-only (`tabular-nums` counts, clock, LAN/bridge status). Never embed text fields, `<select>` config inputs, or action buttons inside passive KPI cells.
- **Persistent right control dock (`36%`):** House hardware status controls, QR/RFID scan triggers, manual bib entry, and editable settings in the dedicated right-hand dock, clearly visually bounded from the left live table (`64%`).
- **Explicit F-key accelerators:** Bind primary operator commands (`F1` Primary Scan/Check-In, `F2` Copy/Assign, `F3` Sync/Refresh, `F4` Export, `Ctrl+F` Search, `Space` Trigger/Pause when safe) with visible keycap badges.
## Mobile Field-Staff Criteria (`390x844`, `100dvh`)
- **Separate status drawer from action dock:** Read-only telemetry expands from the `48px` top bar; primary interactive triggers stay anchored in the `bottom-0` thumb dock.
- **Editable form isolation:** Open editable parameters (chip assignment, manual split edit, checkpoint config) inside a dedicated bottom-sheet dialog so field staff cannot accidentally edit configuration while scrolling the runner list.
## React & Tailwind Audit Patterns
```tsx
// Read-only telemetry ribbon vs right-hand editable dock separation
<section aria-label="Live telemetry" className="h-10 shrink-0 px-4 border-b border-[var(--border-default)] bg-[var(--surface-card)] flex items-center justify-between gap-4 text-xs">
<div className="flex items-center gap-4">
<span className="inline-flex items-center gap-1.5 font-semibold text-emerald-600 dark:text-emerald-400">
<span className="h-2 w-2 rounded-full bg-current" aria-hidden="true" />
LAN Ready
</span>
<span className="font-mono tabular-nums">Reads: <strong>{readCount}</strong></span>
<span className="font-mono tabular-nums">Queue: <strong>{pendingCount}</strong></span>
</div>
<span className="font-mono tabular-nums text-sm font-semibold">{elapsedClock}</span>
</section>
```
## Inspection Evidence
- Audit every metric cell in the telemetry strip to confirm zero `<input>`, `<select>`, or mutable buttons sit inside read-only display chips.
- Verify hardware controls, scanners, and forms reside in the right `36%` dock on desktop and in a bottom sheet / bottom bar on mobile.
- Test keyboard triggers (`F1`-`F4`, `Ctrl+F`, `Space`) and verify live feedback updates immediately on action.
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 |