Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Planowanie

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.

Repozytorium
quality-pack ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
1
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. Ergonomics and information architecture (ERG)
Sekcje z nagłówków SKILL.md, w oryginale · 37 linii, 664 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.