Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Przegląd i audyt

normalize

/normalize

Audytuje i dostosowuje UI do standardów systemu projektowego, odstępów, tokenów i wzorców, gdy pojawia się niespójność lub dryf stylów.

Repozytorium
better-web-ui ↗
Licencja
MIT
Ostatnia zmiana repozytorium
21.05.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
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

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

Co robi i kiedy

Audytuje i dostosowuje UI do standardów systemu projektowego, odstępów, tokenów i wzorców, gdy pojawia się niespójność lub dryf stylów.

Oryginalny opis (EN)

Audit and realign UI to match design system standards, spacing, tokens, and patterns. Use when the user mentions consistency, design drift, mismatched styles, tokens, or wants to bring a feature back in line with the system.

Jak działa

  1. MANDATORY PREPARATION
  2. Plan
  3. Execute
  4. Clean Up
Sekcje z nagłówków SKILL.md, w oryginale · 80 linii, 820 słów
Podgląd SKILL.md
---
name: normalize
description: Audit and realign UI to match design system standards, spacing, tokens, and patterns. Use when the user mentions consistency, design drift, mismatched styles, tokens, or wants to bring a feature back in line with the system.
metadata:
   argument-hint: "[feature (page, route, component...)]"
---

Analyze and redesign the feature to perfectly match our design system standards, aesthetics, and established patterns.

Normalization is not just visual cleanup. It is restoring the feature to the system so spacing, type, color, interaction, and hierarchy all speak the same language again.

Consult the [design-system alignment](../frontend-design/reference/design-system-alignment.md) reference for tokens vs components vs patterns, drift, and when to normalize locally versus escalate to system work.
Consult the [interaction design](../frontend-design/reference/interaction-design.md) reference when normalization includes restoring familiar patterns, improving target sizing, or removing bespoke interaction behavior from standard controls.
Consult the [legacy modernization](../frontend-design/reference/legacy-modernization.md) reference when the feature lives inside a legacy system, mixed old/new flow, or partial migration where low-risk upgrade strategy matters as much as visual alignment.

## MANDATORY PREPARATION

Users start this workflow with `/normalize`. Once this skill is active, load $frontend-design — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow that protocol before proceeding — if no design context exists yet, you MUST load $setup first.

---

## Plan

Before making changes, deeply understand the context:

1. **Discover the design system**: Search for design system documentation, UI guidelines, component libraries, or style guides (grep for "design system", "ui guide", "style guide", etc.). Study it thoroughly until you understand:
   - Core design principles and aesthetic direction
   - Target audience and personas
   - Component patterns and conventions
   - Design tokens (colors, typography, spacing)
   
   **CRITICAL**: If something isn't clear, ask. Don't guess at design system principles.

2. **Analyze the current feature**: Assess what works and what doesn't:
   - Where does it deviate from design system patterns?
   - Which inconsistencies are cosmetic vs. functional?
   - What's the root cause—missing tokens, one-off implementations, or conceptual misalignment?
   - If the feature is legacy or hybrid, which workflows and dependencies would make a "simple redesign" risky?
   - Which pain points can be improved safely now without breaking institutional workflow knowledge?

3. **Create a normalization plan**: Define specific changes that will align the feature with the design system:
   - Which components can be replaced with design system equivalents?
   - Which styles need to use design tokens instead of hard-coded values?
   - How can UX patterns match established user flows?
   - Where have standard interactions drifted away from familiar product conventions without a compelling reason?
   - Which areas feel off because hierarchy is weak, actions are flattened, or spacing is arbitrary rather than systematic?
   
   **IMPORTANT**: Great design is effective design. Prioritize UX consistency and usability over visual polish alone. Think through the best possible experience for your use case and personas first.

   When the surface is legacy, normalization often means making the current experience safer, clearer, and more consistent while a larger migration is still in progress. Do not mistake every legacy problem for a mandate to rewrite the workflow wholesale.

## Execute

Systematically address all inconsistencies across these dimensions:

- **Typography**: Use design system fonts, sizes, weights, and line heights. Replace hard-coded values with typographic tokens or classes.
- **Color & Theme**: Apply design system color tokens. Remove one-off color choices that break the palette.
- **Spacing & Layout**: Use spacing tokens (margins, padding, gaps). Align with grid systems and layout patterns used elsewhere.
- **Hierarchy**: Restore primary, secondary, and tertiary emphasis. A normalized feature should make it obvious what matters first.
- **Components**: Replace custom implementations with design system components. Ensure props and variants match established patterns.
- **Motion & Interaction**: Match animation timing, easing, and interaction patterns to other features.
- **Conventional UX patterns**: Realign forms, tables, filters, dialogs, menus, tabs, and settings to recognizable platform/category conventions unless the custom behavior clearly improves the workflow.
- **Responsive Behavior**: Ensure breakpoints and responsive patterns align with design system standards.
- **Accessibility**: Verify contrast ratios, focus states, ARIA labels match design system requirements.
- **Target sizing & placement**: Restore generous hit areas, whole-row labels where appropriate, and action placement that reduces precision work for common tasks.
- **Progressive Disclosure**: Match information hierarchy and complexity management to established patterns.

**NEVER**:
- Create new one-off components when design system equivalents exist
- Hard-code values that should use design tokens
- Introduce new patterns that diverge from the design system
- Compromise accessibility for visual consistency
- Normalize by making everything visually similar while leaving hierarchy unclear

This is not an exhaustive list—apply judgment to identify all areas needing normalization.

## Clean Up

After normalization, ensure code quality:

- **Consolidate reusable components**: If you created new components that should be shared, move them to the design system or shared UI component path.
- **Remove orphaned code**: Delete unused implementations, styles, or files made obsolete by normalization.
- **Verify quality**: Lint, type-check, and test according to repository guidelines. Ensure normalization didn't introduce regressions.
- **Ensure DRYness**: Look for duplication introduced during refactoring and consolidate.

Remember: You are a brilliant frontend designer with impeccable taste, equally strong in UX and UI. Your attention to detail and eye for end-to-end user experience is world class. Execute with precision and thoroughness.

Wersje

RepozytoriumWynikLicencja
Ta strona · aladicf/better-web-ui90MIT
MarkForest/normalize-prompt100MIT
smooai/smooth100MIT
growupanand/ConvoForm90Apache-2.0
akarachen/aghub90MIT

Migawka bazy z 13.11.2026 · wersja paczki d9a03673d6fb (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

  • 100design-tokens
    Konfiguruje tokeny projektowe w projekcie, który ich nie ma, i wychwytuje dryf w istniejących: paleta, skala odstępów, promienie, typografia, cienie, tryb ciemny.
  • 100design-tokens
    Generuje plik tokenów projektowych (zmienne CSS lub konfiguracja Tailwind) według wybranej filozofii estetycznej, z paletami jasną i ciemną, skalą odstępów i tokenami komponentów.
  • 100generate-ui-from-brand
    Prowadzi od adresu URL lub DESIGN.md do tokenów, decyzji i specyfikacji UI, dla marki istniejącej lub audytu systemu projektowego.
  • 95form-tokens
    Pomaga zdefiniować system tokenów projektowych: tworzy i dokumentuje tokeny, zmienne CSS, konfigurację Tailwind, skalę odstępów i semantykę kolorów, łącząc decyzje projektowe z kodem.
  • 100frontend-design
    Podaje zasady projektowania komponentów UI, hierarchii wizualnej, odstępów i typografii dla aplikacji Next.js oraz ustawia design tokeny i spójność wizualną.
  • 100sb-health
    Sprawdza stan systemu projektowego aplikacji React i Vite: surowe kolory hex, nieużywane tokeny, luki w skali i dryf względem pliku DESIGN.md.

Uwagi i zgłoszenia

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