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-9241-112.md
View on GitHub# ISO 9241-112: Principles for the Presentation of Information
## Standard Identity & Scope
- **Designation:** ISO 9241-112 (Ergonomics of human-system interaction, Part 112: Principles for the presentation of information).
- **Scope:** Modality-independent principles ensuring presented information is detectable, distinguishable, clear, concise, consistent, and legible across visual and auxiliary displays.
## Core Principles Audited by This Skill
1. **Detectability:** Critical statuses, live connectivity indicators, and active timing counters must stand out immediately without hunting through decorative chrome.
2. **Discriminability:** Adjacent states (`Paid` vs `Pending`, `Finished` vs `DNF`, `Online` vs `Offline`, `Read-Only Telemetry` vs `Editable Input`) must differ clearly through shape, label, and contrast rather than subtle hue shifts alone.
3. **Clarity & Conciseness:** Eliminate verbose welcome paragraphs, marketing hero banners inside operational consoles, redundant multi-line card headers, and eyebrow capsule badges (`AGENTS.md` Hard Gate).
4. **Consistency:** Use uniform number formatting, timestamps, badge semantics, and unit placements across every row, telemetry strip, and modal.
5. **Legibility:** Enforce high contrast and `tabular-nums` alignment for all live clocks, bib numbers, split times, counts, and currency values so digits never jitter horizontally as values update.
## Desktop Console Criteria (`1080p` / `1366x768`, `100vh`)
- **Zero decorative welcome banners:** Strip greeting cards, explanatory prose blocks, and multi-tier headers that push operational data down the screen.
- **High-density telemetry ribbon (`<= 40px`):** Replace oversized KPI hero tiles with a single horizontal readout strip using `tabular-nums` (`font-mono tabular-nums` or `font-sans tabular-nums`) for aligned counts and clocks.
- **Strict column scanability:** Right-align numeric metrics, timestamps, and currency columns; left-align runner names and categories; truncate overflowing secondary strings with accessible full titles (`title` or expandable detail).
## Mobile Field-Staff Criteria (`390x844`, `100dvh`)
- **Outdoor sunlight contrast:** Enforce strong foreground-to-surface contrast (targeting WCAG AAA `7:1` where feasible for critical field status labels and primary action text, and strictly at least WCAG AA `4.5:1` / `3:1` large text per `R-25`).
- **2-line hybrid card legibility:** Restrict each row card to high-signal fields:
- Line 1: `Bib #` (`tabular-nums font-semibold`) + `Runner Name` + `Status Badge`
- Line 2: `Category` + `Official Time` (`tabular-nums`) + `One-Tap Action`
- **No color-only status encoding:** Pair semantic color fills/borders with explicit text labels or distinct icons (`R-39`).
## React & Tailwind Audit Patterns
```tsx
// Telemetry readout cell: tabular alignment + concise label + explicit contrast
<div className="flex items-center gap-2 px-3 py-1 border-r border-[var(--border-default)]">
<span className="text-xs font-normal text-[var(--text-secondary)]">Checked In</span>
<span className="text-sm font-semibold font-mono tabular-nums text-[var(--text-primary)]">
{checkedInCount} / {totalCount}
</span>
</div>
```
## Inspection Evidence
- Measure text and badge foreground/background contrast ratios across light and dark modes (using `antislop-human/contrast-check.py` or inspected tokens) to confirm `>= 4.5:1` normal / `>= 7:1` outdoor critical targets (`R-25`, `R-34`).
- Inspect numeric columns, live timers, and KPI strip values for `tabular-nums` classes (`font-mono tabular-nums` or `tabular-nums`).
- Confirm zero decorative hero banners, eyebrow pills, or redundant section titles remain inside the operational viewport.
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 |