build-ergonomics
/build-ergonomics
Porządkuje ekran, w którym użytkownik wykonuje zadanie: liczbę ustawień, zakładki, kroki, podgląd i domyślne wartości.
- Autor
- 1AngelMicka ↗
- Repozytorium
- quality-pack ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 1
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
Co robi i kiedy
Porządkuje ekran, w którym użytkownik wykonuje zadanie: liczbę ustawień, zakładki, kroki, podgląd i domyślne wartości.
Oryginalny opis (EN)
Shipwright build rules for Ergonomics (Ergonomics and information architecture). Use when designing or reorganising a screen where users do a task: how many settings show at once, tabs or steps, where the preview and the main action sit, phone versus desktop layouts, defaults and presets that could overwrite a user's choice, or when a screen feels long, crowded or tiring. FR: ergonomie, organisation de l'écran, onglets, étapes, aperçu, réglages, page trop longue, téléphone et ordinateur.
Jak działa
- Ergonomics and information architecture (ERG)
Podgląd SKILL.md
--- name: build-ergonomics description: "Shipwright build rules for Ergonomics (Ergonomics and information architecture). Use when designing or reorganising a screen where users do a task: how many settings show at once, tabs or steps, where the preview and the main action sit, phone versus desktop layouts, defaults and presets that could overwrite a user's choice, or when a screen feels long, crowded or tiring. FR: ergonomie, organisation de l'écran, onglets, étapes, aperçu, réglages, page trop longue, téléphone et ordinateur." --- <!-- Generated by tools/build.py from the referential YAML. Do not edit by hand. --> # Ergonomics: build rules Apply these rules while you build. Domains or criteria whose `applies_if` flags are false in `.quality/project.json` do not apply to this project. Before you call a task done, check your work against the criteria of the domains you touched: each one must be true and verifiable. If a stack module of Shipwright is installed (sw-nextjs, sw-node-api, sw-vps, sw-expo, sw-capacitor, sw-tauri, sw-electron), its rules skill adds stack-specific rules on top of these. ## Ergonomics and information architecture (ERG) How screens are organised and how much effort each key task takes, measured by playing the tasks on a phone and on a desktop, not only the hygiene of each screen. Applies when: The project has a user interface. Rules: - List 2 to 5 key tasks at /sw:kickoff (project.json › flows), with their test data, and design the screens from them. - Past a dozen settings, group them in tabs, steps or collapsible sections; an endlessly scrolling settings page is never the answer. - The result (preview, total, rendering) stays visible while adjusting; on a phone, preview on top and settings panel below. - The main action is reachable without scrolling, and under the thumb on a phone (bottom action bar). - Settings follow the order of the task, one decision at a time, with a recommended option already selected; advanced settings are set apart. - A theme, template or default never overwrites a user's choice without saying so and offering undo. - Design the phone and the desktop separately: each gets its own layout, not the same page stretched or shrunk. - Take from the references named in DESIGN.md their organisation (screen structure, navigation, gestures), not only their colours. Done means: - [major] ERG-01: Key tasks are declared and play to the end on a phone and on a desktop. Check: 2 to 5 flows in project.json › flows, with test data; flows.json: every run completed on both devices. No flows: fail. - [major] ERG-02: Each task stays within the effort budget: pages to scroll, screens scrolled through, actions. Check: flows.json: over_budget empty for every run, on phone and desktop (budgets in scoring.yaml › flow_budgets or in the flow). Only one device within budget: partial. - [major] ERG-03: Few settings shown at once; beyond that, tabs, steps or collapsible sections. Check: flows.json: max_controls_rendered under budget at every step; if over, uses_disclosure must be true and the screenshot must show one group open at a time. - [major] ERG-04: The result stays visible while adjusting. Check: Flows that declare preview: preview_visible_while_adjusting of at least 0.8 on both devices. No result to show in the product: n/a, with the reason. - [major] ERG-05: The main action is reachable without scrolling, under the thumb on a phone. Check: Flows that declare primary: primary_visible true on both devices and primary_in_thumb_zone true on phone. - [major] ERG-06: A user's choice is never overwritten silently (theme, template, default value). Check: Read the code that applies a theme, template or preset; in a flow, make a choice then apply the theme: the choice stays, or a message offers undo. - [major] ERG-07: Settings follow the order of the task, one decision at a time, with a recommended option. Check: On the flow screenshots: what the user decides first comes first, a recommended option is preselected (or "choose for me"), advanced settings are set apart. - [major] ERG-08: The app follows how the DESIGN.md references are organised, not only their palette. Check: For each reference in DESIGN.md › "What we borrow": the principle (preview + toolbar, tabbed panels, steps…) shows on the screenshots, on phone and desktop. No borrow list: fail. - [major] ERG-09: Heuristic review of the key tasks: no critical problem, no open major one. Check: Review by the ergonomist agent (Nielsen's heuristics, Bastien and Scapin's criteria) on the screenshot of every step, phone and desktop separately. One critical: fail; one major: partial.
Wersje
W bazie nie ma innych skilli o nazwie build-ergonomics.
Migawka bazy z 13.11.2026 · wersja paczki 7a09544eaa0e (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90design-screens
Układa ekrany przed kodowaniem: liczbę paneli przy szerokości okna, powłokę układu, nawigację i miejsce głównej akcji dla telefonu i komputera. - 100settings-architecture
Projektuje drzewo ustawień panelu administracyjnego i układ każdej strony ustawień: grupy, nawigację, szerokość i zakres zapisu.