Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Nauka i wyjaśnianie

styling-best-practices

/styling-best-practices

Podpowiada zasady stylowania komponentów UI: najpierw tokeny projektowe, motyw, właściwości CSS i rozszerzenia Otter.

Repozytorium
otter ↗
Licencja
BSD-3-Clause
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

BSD-3-Clause, otwarta.

Co robi i kiedy

Podpowiada zasady stylowania komponentów UI: najpierw tokeny projektowe, motyw, właściwości CSS i rozszerzenia Otter.

Oryginalny opis (EN)

This skill should be used when developing UI components, writing CSS/SCSS styles, or when the user asks about design tokens, theming, CSS custom properties, or styling conventions. Guides token-first development and Otter extensions usage.

Jak działa

  1. Core Rule: Token-First
  2. Token Selection Rules
  3. Fallback Questions
  4. Finding Tokens
  5. Otter Extensions (for token JSON definitions)
  6. Naming Conventions
  7. When NOT to Use Tokens
  8. Stop Rules
Sekcje z nagłówków SKILL.md, w oryginale · 77 linii, 482 słów
Podgląd SKILL.md
---
name: styling-best-practices
description: This skill should be used when developing UI components, writing CSS/SCSS styles, or when the user asks about design tokens, theming, CSS custom properties, or styling conventions. Guides token-first development and Otter extensions usage.
---

# Styling Best Practices

## Core Rule: Token-First

**ALWAYS use design tokens (CSS custom properties) instead of hardcoded values** for colors, spacing, typography, border-radius, shadows, and animation durations.

### Decision Rules

1. Use the `find_design_token` MCP tool to discover available tokens.
2. Apply the following decision tree:

- If token found → recommend it and explain why.
- If multiple tokens match → ask the user to choose.
- If no token matches → ask for more precise intent or broader context.
- If only a primitive matches → prefer a semantic token / ask whether a semantic alias should be created.

## Token Selection Rules

- If an exact component token exists, use it.
- Else if a semantic token exists, use it.
- Else if only a primitive token exists, use it only as a fallback and mention that a semantic token would be better.
- Else ask the user for clarification.

## Fallback Questions

Ask for:
- the visual intent (color, spacing, size, radius, shadow, etc.)
- the semantic meaning (primary, success, danger, neutral, etc.)
- the expected scope (component-specific or global)
- whether a primitive fallback is acceptable

```scss
/* ❌ BAD */
.card { background: #ffffff; padding: 16px; border-radius: 8px; }

/* ✅ GOOD */
.card { background: var(--colors-surface); padding: var(--spacing-md); border-radius: var(--shape-corner-medium); }
```

## Finding Tokens

Use `find_design_token` with the CSS property and a semantic description of the need.
If no results, try broader terms or use `list_design_tokens` to browse by category.

## Otter Extensions (for token JSON definitions)

| Extension | Purpose | Example |
|-----------|---------|---------|
| `o3rPrivate: true` | Internal token, not exposed to CMS | Implementation details |
| `o3rScope: '<selector>'` | Scope CSS property to a selector instead of `:root` | Component-specific tokens |
| `o3rExpectOverride: true` | Token designed to be overridden (theming/rules engine) | Brand colors |
| `o3rImportant: true` | Generates with `!important` (use sparingly) | Legacy CSS specificity battles |
| `o3rUnit: '<unit>'` | Converts unitless value to a CSS unit (`px`, `rem`, `em`, `%`, `vw`, `vh`, `ms`, `s`) | Figma-extracted raw numbers |
| `o3rRatio: <number>` | Applies a multiplier to numeric value | Derived spacing/type scales |
| `o3rMetadata: {...}` | CMS metadata (tags, label, category, component) | Design system portal discoverability |

## Naming Conventions

- **kebab-case**: `colors-primary`, not `colorsPrimary`
- **Structure**: `{category}-{subcategory}-{variant}-{state}`
- **Categories**: `colors-*`, `spacing-*`, `typography-*`, `shape-*`, `elevation-*`, `motion-*`
- **Semantic names**: `colors-primary`, not `blue-500`; `spacing-md`, not `size-3`

## When NOT to Use Tokens

Skip tokens for: one-off layout values, z-index layering, `@keyframes` intermediate values, structural CSS (`display`, `position`, `overflow`), content-coupled dimensions (`max-width: 65ch`).

## Stop Rules

Halt and ask for clarification if:

- No matching token exists for a needed value
- A hardcoded color/spacing is being used where tokens are available
- A primitive token is used where a semantic alternative exists
- A new token needs to be created

Wersje

W bazie nie ma innych skilli o nazwie styling-best-practices.

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

  • 82design-system
    Generuje, wyciąga i sprawdza tokeny projektowe: zapisuje DESIGN.md, eksportuje zmienne CSS lub motyw Tailwind.
  • 100jaspr-styling
    Pisze typowo bezpieczny CSS w Dart do stylowania komponentów Jaspr, wdrażania motywów i używania właściwości CSS.
  • 100design-systems
    Opisuje architekturę design systemu i tokenów: specyfikacja W3C, atomic design, dokumentacja komponentów, motywy, tryb jasny i ciemny oraz zmienne CSS.
  • 100tailwind-patterns
    Dobiera wzorce Tailwind CSS v4 do stylowania komponentów, trybu ciemnego i integracji z systemem projektowym.
  • 100design-build
    Wdraża i poprawia wizualny projekt frontendu: CSS, układ, typografię, tokeny kolorów i stany komponentów.
  • 100tokens
    Audytuje kolory, rozmiary i czcionki w stylach repozytorium, a potem definiuje tokeny projektowe w jednym źródle W3C.

Uwagi i zgłoszenia

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