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-161.md
View on GitHub# ISO 9241-161: Visual User-Interface Elements
## Standard Identity & Scope
- **Designation:** ISO 9241-161 (Ergonomics of human-system interaction, Part 161: Visual user-interface elements; Second edition 2025).
- **Scope:** Requirements and recommendations governing when and how standard GUI elements (toolbars, sticky headers, split panes, filter controls, buttons, list boxes, modal dialogs, status indicators) are selected and operated.
## Core Principles Audited by This Skill
1. **Element-to-task fit:** Select native semantic controls (`<button>`, `<a href>`, `<select>`, `<input>`, `<table>`) matched to the interaction type rather than clickable `<div>` elements or decorative wrappers (`R-39`).
2. **Persistent command & context elements:** Keep primary toolbars, search inputs, filter pills, and table column headers sticky (`sticky top-0`) while scrolling long datasets so context never scrolls off-screen.
3. **Standardized split-pane & dialog behavior:** Master-detail panes must scroll independently (`min-h-0 overflow-y-auto`), and dialogs/drawers must trap or manage focus cleanly, dismiss on `Escape`, and escape clipped parent stacking contexts via portals (`DialogSurface`).
4. **Clear visual state affordances:** Interactive elements must exhibit unmistakable default, hover, active, disabled, and `:focus-visible` states plus `cursor: pointer` / `cursor: not-allowed` (`R-32`, `R-39`).
## Desktop Console Criteria (`1080p` / `1366x768`, `100vh`)
- **Sticky table headers (`<thead class="sticky top-0">`):** Column headers remain locked at the top of the left `64%` scroll container (`flex-1 min-h-0 overflow-y-auto`) while scrolling hundreds of runners.
- **Filter pill & search toolbar:** Keep filter chips and search input pinned immediately above the master list inside the left pane so filtering never shifts the right-hand control dock.
- **Portaled modal dialogs:** Render blocking confirmations and overlays through `src/components/ui/DialogSurface.tsx` (`document.body` portal) so `overflow-hidden` split panes never clip dialogs.
## Mobile Field-Staff Criteria (`390x844`, `100dvh`)
- **Sticky bottom command bar (`bottom-0`):** Anchor primary actions in a persistent footer with sufficient bottom padding (`pb-24`) on the main scroll area so the final card row is never obscured (`racepulse-launch-ux-states`).
- **Scrollable filter strip:** Render filter pills in a clean horizontally scrollable row (`overflow-x-auto`) with `min-h-11` (`44px`) hit areas instead of wrapping into a 3-row block that steals vertical space.
- **Bottom-sheet modal ergonomics:** Convert desktop right-dock tools into modal bottom sheets with explicit close buttons and `Escape` support.
## React & Tailwind Audit Patterns
```tsx
// Independent scroll pane with sticky table header and min-h-0 flex discipline
<section className="flex flex-col flex-1 min-h-0 lg:w-[64%] border-r border-[var(--border-default)]">
<div className="shrink-0 p-3 border-b border-[var(--border-default)] flex items-center gap-2">
<input
type="search"
aria-label="Search runners by bib or name"
placeholder="Search bib or name (Ctrl+F)"
className="h-11 lg:h-9 flex-1 px-3 rounded-md border border-[var(--border-default)] bg-[var(--surface-page)] text-sm"
/>
</div>
<div className="flex-1 min-h-0 overflow-y-auto">
<table className="w-full border-collapse">
<thead className="sticky top-0 z-10 bg-[var(--surface-card)]">
{/* Column headers stay pinned during scroll */}
</thead>
<tbody>{/* Rows */}</tbody>
</table>
</div>
</section>
```
## Inspection Evidence
- Verify `min-h-0` is applied on flex/grid scroll containers inside `lg:h-screen lg:overflow-hidden` so inner panes scroll without overflowing the `<body>`.
- Verify `<thead class="sticky top-0">` stays pinned when scrolling the left master table.
- Verify every button, tab, filter pill, and `<select>` shows visible `:focus-visible` outlines and works via keyboard (`R-32`, `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 |