web-design
/web-design
Projektuje interfejs i ruch dla konkretnego produktu, z responsywnymi układami i kierunkiem w DESIGN.md.
- Autor
- ADWilkinson ↗
- Repozytorium
- astack ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 12.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 14
- Skrypty
- 2
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 4
Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/render-gate.mjs, scripts/shoot.mjs
Co robi i kiedy
Projektuje interfejs i ruch dla konkretnego produktu, z responsywnymi układami i kierunkiem w DESIGN.md.
Oryginalny opis (EN)
Design product-specific web UI, responsive layouts and motion; keep the direction in DESIGN.md. Use for new pages, redesigns, generic-looking UI, janky animation, awkward phone behavior or layouts stressed by long or empty data.
Jak działa
- 1. Load or create the design context
- 2. Decide the direction
- 3. Build in the product's system
- 4. Look at it
- 5. Finish
- Rules
Podgląd SKILL.md
---
name: web-design
description: "Design product-specific web UI, responsive layouts and motion; keep the direction in DESIGN.md. Use for new pages, redesigns, generic-looking UI, janky animation, awkward phone behavior or layouts stressed by long or empty data."
---
# Web design
Generated UI fails in predictable ways: the same fonts, the same violet gradient, cards inside cards, a centred hero with three icon tiles, decoration standing in for a point of view. This skill replaces defaults with decisions, then checks the rendered result.
`<skill-dir>` below means this skill's own folder. Run its scripts from the project root so output lands in the project, not in the installed skill.
## 1. Load or create the design context
Look for `DESIGN.md` (also `docs/DESIGN.md`, `BRAND.md`). If it exists, read it before touching UI; its tokens and rules win over your taste. If it does not exist and the work is more than a small fix, create one from [the template](references/design-md-template.md) by reading the code: real tokens from the CSS/Tailwind config, real fonts, real components. Mark anything you inferred as inferred.
Update DESIGN.md when a session makes a durable decision (a new token, a rejected direction and why). This is how the next session avoids regressing to defaults.
## 2. Decide the direction
**Name the mode first.** It sets how much boldness the surface earns:
- **Persuade** (landing, pricing, launch pages): the design is the product; commit to a point of view.
- **Operate** (app UI, dashboards, settings, forms): precision and restraint; familiar patterns earn their place; brand lives in details.
- **Read** (docs, articles, changelogs): structure for comprehension, then make reading pleasant.
- **Experience** (portfolios, showcases, games): the work leads; the interface recedes.
**Refining or redesigning?** Refining keeps the current identity, copy and behaviour and improves within it. Redesigning keeps the product's facts and function but replaces the look entirely. Never split the difference by polishing a look you mean to discard.
**Then plan in two passes before writing code.**
Pass one, the plan:
- **Job**: who is here, what they need first, the next action.
- **Palette**: four to six named hex values, with where the accent is allowed.
- **Type**: faces and their roles, the scale, numerals.
- **Layout**: a sentence and a rough ASCII wireframe; alignment stated.
- **The one bold thing**: the single memorable element. Everything around it stays quiet.
Pass two, the generic test: would you have produced this plan for any similar brief? Check it against the [current AI-default looks](references/anti-patterns.md#the-current-defaults), which change over time. Cream background with a serif display and a terracotta accent, near-black with one acid accent, and broadsheet hairlines are today's clusters, as purple gradients were last year's. If a part of the plan matches a default the brief did not ask for, replace it and write down what you changed and why. The brief's own words always win, including when it asks for one of these looks.
Choose from the subject's world: its materials, places, artefacts and vocabulary. A dog walker's site and an analyst's dashboard should not be able to swap palettes.
When the user gives references, study them properly: [reference study](references/reference-study.md) pulls computed styles from the live sites so you borrow relationships (scale, rhythm, density), not surface decoration.
When two directions both survive the generic test and the choice is hard to argue from a plan, prototype instead of debating: build two or three variants of just the contested piece behind a development-only switch (`?variant=b`), shoot each at the same widths and states, choose with the user or the rubric, and delete the losers before finishing. Variants differ in one decision each (layout, type pairing, density), so the comparison says something.
## 3. Build in the product's system
- Use existing tokens, primitives and components. Add a token before adding a one-off value.
- Components that are hard to get right by hand (toasts, drawers and sheets, comboboxes, date pickers, virtualised lists, drag and drop) come from the project's primitive. If it has none and a dependency is in scope, choose a maintained, accessible, headless library over hand-rolling one: check its last release, open issues, bundle size and keyboard support first, and record the choice in DESIGN.md.
- Real content only: real names, long names, real numbers, empty data. Never lorem ipsum, never invented metrics to fill a layout. Before calling a data-driven screen done, run it on [worst-case data](references/worst-case-data.md): the longest plausible name, an unbreakable email, a count of 1 and of 1,284, an empty list, a missing avatar. A workspace also runs at the plan limit, with seeded records: [workspace at scale](references/workspace-scale.md).
- Design the states with the screen: loading, empty, error, success, disabled, overflow. An empty state that looks broken is a bug. A loading state is the loaded layout with content replaced by bones of the same boxes. A shorter stack of bars is a jump. Mark the stable regions and compare the two states: [loading](references/loading.md).
- Hide what has nothing to say. Zero rows, zero balances and empty charts become an honest empty state or disappear; no walls of zeros.
- Headers are labels. A subtitle that re-explains the header gets deleted.
- Mobile is its own layout: reorder by priority, use horizontal snap rails where desktop uses grids, `dvh`/`svh` not `100vh`, inputs at 16px or larger, tap targets 44px. Anything people use on a phone gets the [mobile baseline](references/mobile.md): no tap flash, hover gated to real pointers, press feedback on touch, safe areas, no zoom on focus.
Hold the line on the [craft floor](references/craft-floor.md) while building, not as a final pass. For any animation or transition, read [motion](references/motion.md) first: decide whether it should animate at all (never for keyboard or high-frequency actions), ease-out and under 300ms for UI, press feedback and origin-aware popovers, interruptible transitions, only `transform` and `opacity`, reduced motion handled, and watched as a filmstrip. The same reference names effects when the request is vague, gives several moving elements one lead, diagnoses janky animation by cause, and audits a whole app's motion into keep, fix and cut with `file:line` and a verdict.
## 4. Look at it
```sh
node <skill-dir>/scripts/shoot.mjs http://localhost:3000/page --full # 390 + 1440, light + dark
node <skill-dir>/scripts/shoot.mjs http://localhost:3000/page --widths 320,390,768,1440 --themes light
node <skill-dir>/scripts/shoot.mjs http://localhost:3000/page --click '[aria-controls=menu]' --widths 390
node <skill-dir>/scripts/shoot.mjs loading.html --shift loaded.html --widths 390 --themes light
```
Open every screenshot and actually read it. Then read the lines under each capture. `shoot.mjs` reports inputs under 16px, a viewport that disables zoom, `:hover` rules outside `@media (hover: hover)`, selectable controls on a narrow viewport, and a missing tap-highlight reset. None of those show up as overflow. A `--shift` run exits 1 when a marked region or the document scroll height moved, and exits 2 when nothing was marked. Exit 2 is not a pass. Then go through, in this order:
1. **First read**: squint. Is the most important thing the most prominent? Can you tell what this is and what to do in three seconds?
2. **Broken**: overflow, clipped text, overlapping layers, stranded words, invisible focus, dark mode contrast. `shoot.mjs` flags several of these; check its output.
3. **Hierarchy and rhythm**: more space above a heading than below it; consistent gaps within groups, larger between groups; one primary action per view.
4. **Generic**: run `deslop`'s scan or check [anti-patterns](references/anti-patterns.md). Would a stranger guess this product from a screenshot with the logo removed?
5. **Craft**: alignment to the pixel at 2x, optical balance of icons and text, tabular numbers in columns.
6. **Stress**: the worst-case fixture at the real container width, 320px and 200% text. Touch details need a real phone; say so if you had none.
Then gate what eyes miss. When the project has a DESIGN.md or the brief supplies copy, run:
```sh
node <skill-dir>/scripts/render-gate.mjs http://localhost:3000/page --size 390x844 --size 1440x900 --design DESIGN.md --expect "Exact headline"
```
It fails on a brand face that silently fell back, supplied copy that changed, text clipped by its box or cropped by the canvas, and painted colours or faces outside the tokens. Exit 2 means it could not check, which is not a pass.
Fix the worst problem, re-shoot, repeat. Compare against references at the same width and state. Two or three full loops is normal for new work.
For new pages, redesigns and anything public, finish with a verdict from the [review rubric](references/review-rubric.md): three gates, six areas scored 1 to 5 with evidence, ship / fix / rework. When an independent agent is available, it scores from its own renders, not yours.
## 5. Finish
Report the screens and states you inspected (widths, themes), the gate results and rubric verdict, the decisions you made, and anything not inspected (authenticated states you could not reach, real data you did not have). Commit DESIGN.md changes with the UI.
## Rules
- The user's brief and DESIGN.md beat this skill. If the brand is purple gradients, it is purple gradients.
- No new UI library, icon set or font for a local change.
- Do not invent social proof, testimonials, logos, user counts or "trusted by".
- Do not fake liveness: no pulsing "Live" dots, tickers or activity unless backed by real data at that cadence ("Updates every 10s" when that is true).
- Never collapse distinct states (submitted, accepted, confirmed) into one success tick.
Pliki w paczce (14)
- SKILL.md 10 KB
- agents/openai.yaml 1 KB
- references/anti-patterns.md 9 KB
- references/craft-floor.md 5 KB
- references/design-md-template.md 2 KB
- references/loading.md 5 KB
- references/mobile.md 5 KB
- references/motion.md 19 KB
- references/reference-study.md 2 KB
- references/review-rubric.md 5 KB
- references/workspace-scale.md 3 KB
- references/worst-case-data.md 5 KB
- scripts/render-gate.mjs 23 KB
- scripts/shoot.mjs 28 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · ADWilkinson/astack | 100 | MIT |
| DanielC000/loom | 100 | MIT |
| 3x-haust/ondra | 100 | MIT |
| akillness/jeo-skills | 100 | MIT |
| travnie/twojstar | 100 | ISC |
| vkirill/claude-lane-stack | 100 | MIT |
| countbot-ai/countbot | 100 | MIT |
| xiaopu-ai/web-design | 100 | MIT |
| zenobi-us/dotfiles | 90 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki c1abea9db239 (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
- 100frontend-design
Projektuje i buduje interfejsy frontendowe z systemami designu, responsywnymi układami, dostępnymi komponentami i obsługą trybu ciemnego. - 100design-craft
Projektuje lub znacząco poprawia interfejsy z kierunkiem wizualnym specyficznym dla produktu, hierarchią treści i krytyką renderu, dla nowych ekranów, landing pages, redesignów i typografii. - 100frontend-design-quality
Projektuje i ulepsza interfejs frontendu z jasnym kierunkiem wizualnym i użytecznymi stanami, dla stron, dashboardów i ekranów produktu. - 100cinematic-scroll
Projektuje i buduje filmowe strony, portfolia i opowieści produktowe z choreografią przewijania i grafiką 3D w czasie rzeczywistym, z wersjami responsywnymi, reduced-motion i statycznymi. - 100web-design-guidelines
Podpowiada dobre praktyki projektowania stron: dostępność, układ responsywny i kontrast kolorów w całej aplikacji. - 90fec-ui-design
Buduje i ulepsza interfejs frontendowy z kierunkiem projektowym dopasowanym do produktu: system projektowy, tożsamość wizualna, hierarchia pierwszego ekranu, stany interakcji i responsywność.