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

design-system

/design-system

Buduje kolor akcentu i system designu dla aplikacji Windows: tokeny XAML i C# oraz plik DESIGN-SYSTEM.md z zasadami użycia.

Repozytorium
bawa ↗
Licencja
MIT
Ostatnia zmiana repozytorium
01.11.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
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.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 robi i kiedy

Buduje kolor akcentu i system designu dla aplikacji Windows: tokeny XAML i C# oraz plik DESIGN-SYSTEM.md z zasadami użycia.

Oryginalny opis (EN)

Accent color and design system for a Windows app, from the app's accent and the accent picker in Settings to XAML and C# tokens plus a design/DESIGN-SYSTEM.md that says which token to use when. Use when the user wants a brand or accent color, wants people to pick a color, when an app has more than a few screens, when screens drift apart or animations feel inconsistent, or when the user asks for themes, a style guide, or design tokens.

Jak działa

  1. 1. Pick the accent
  2. 2. Collect
  3. 3. Write the tokens
  4. 4. Write design/DESIGN-SYSTEM.md
  5. 5. Migrate
  6. 6. Point agents at it
Sekcje z nagłówków SKILL.md, w oryginale · 137 linii, 990 słów
Podgląd SKILL.md
---
name: design-system
description: Accent color and design system for a Windows app, from the app's accent and the accent picker in Settings to XAML and C# tokens plus a design/DESIGN-SYSTEM.md that says which token to use when. Use when the user wants a brand or accent color, wants people to pick a color, when an app has more than a few screens, when screens drift apart or animations feel inconsistent, or when the user asks for themes, a style guide, or design tokens.
---

# Design system

A design system is a short list of **tokens** in code and one page that
says which token to use when. Every screen uses tokens, never raw values.
Then a change in one place changes the whole app, and an agent can review
a screen against one page.

Start from `windows-design`. WinUI already ships hundreds of theme
resources (`TextFillColorPrimaryBrush`, `ControlCornerRadius`). Tokens
cover only what WinUI does not: the accent, custom surfaces, spacing,
motion, overlays, and custom controls.

The app keeps the Fluent look. Only the accent changes. For parts of your
own (a custom navigation rail, buttons, icons), call the Skill tool with
`design-kit`. To copy the look of an app the user names, call it with
`design-from-app`.

The template already has the base in `src/<App>/UI/`:

- `Theme.cs`: the accent choices (`Theme.All`), `Theme.ApplyAccent`, which
  writes the seven `SystemAccentColor` shades WinUI derives every accent
  brush from, the app theme modes, and `Theme.Reapply`, which makes a new
  accent show at once.
- `Pages/SettingsPage`: Settings > Appearance, where people pick the app
  theme and the accent. "Use system setting" and "Windows default" are the
  defaults.
- `Space.xaml` and `Grid.cs`: spacing (see the `layout-grid` skill).

## 1. Pick the accent

Read `## Look` in `docs/BRIEF.md`. With no color named, keep `system`: it
follows the accent the person set in Windows Settings > Personalization >
Colors.

For a brand color, add an `AccentChoice` to `Theme.All` with its base
color. `ApplyAccent` derives the light and dark shades: light mode fills
with Dark1 and writes accent text with Dark2; dark mode fills with Light2
and writes with Light3. Check that white text on the base reads well; for
yellow, mint, or cyan pick a deeper base. Keep `Theme.DefaultId = "system"`
unless the owner asks for the brand by default: Windows people expect
their own accent, and the person can still pick the brand in Settings.

Use brand color sparingly: the app icon, an empty state, one hero element
in the content. Keep it off most controls.

To compare colors, take snapshots with `tools/snap.ps1 -Accent <id>` for
two or three of them and show the user the PNGs.

Check: `Theme.DefaultId` is "system" (or the owner chose otherwise in
writing), and the snapshots show the accent on the accent button, toggles,
and the selection pill in light and dark mode.

## 2. Collect

New app with no pages yet? Skip this step: write the token files with the
defaults below before the first page.

Existing app: read every page. List each raw value you find: hex colors,
opacities, corner radii, margins, paddings, widths, animation durations
and easing, custom styles. Group them. Most apps have 3 to 5 of each where
1 or 2 are meant.

## 3. Write the tokens

Accent values live in `Theme.cs`. The rest get one file per group in
`src/<App>/UI/`, merged in `App.xaml`. Add each token when the app first
needs it:

| File | Holds |
| --- | --- |
| `Theme.cs` | accents, app theme, `ApplyAccent`, `Reapply` |
| `Space.xaml` + `Grid.cs` | the spacing scale (`SpaceXs` to `SpaceSection`, `PageMargin`, `CardPadding`) and the layout probes |
| `Surfaces.xaml` | custom brushes in `ThemeDictionaries` (`Light`, `Dark`, `HighContrast`): `SurfaceSubtle`, `SurfaceHover`, `Hairline`, one warning color |
| `Radius.xaml` | only when WinUI's `ControlCornerRadius` (4) and `OverlayCornerRadius` (8) are not enough: chips and key caps 4, cards 8, a hero panel 12 |
| `Layout.xaml` | `ContentMaxWidth`, `ListColumnWidth` (a `GridLength`), fixed dialog widths |
| `Motion.cs` | durations and easing: `Fast` 83 ms, `Normal` 167 ms, `Slow` 250 ms (Fluent's timings), and `Animate` that returns zero when "Animation effects" is off |
| `Styles.xaml` | named styles: `CardStyle`, `EmptyStateGlyph`, `KeyCapStyle` |
| `Overlay.cs` | one builder for borderless panels: size, position, entrance, exit |

Brushes adapt to light, dark, and high contrast through
`ThemeDictionaries`. Pages read them with `{ThemeResource ...}`, never
`{StaticResource ...}`, so a theme change redraws them.

## 4. Write design/DESIGN-SYSTEM.md

One section per file above. Each section says which token to use when, and
the rules that go with it. Keep it under 100 lines. Rules that transfer to
most apps:

- Never hard-code a hex accent. Use `AccentFillColorDefaultBrush` and
  friends; they follow `Theme.ApplyAccent`.
- Every custom brush has three theme values: `Light`, `Dark`, and
  `HighContrast` (which points at a system color like
  `SystemColorWindowTextColor`).
- Never reuse a semantic brush for another job (a stroke brush as text, a
  text brush as a fill). Their values change between releases.
- `{ThemeResource}` for anything that changes with the theme;
  `{StaticResource}` only for numbers, thicknesses, and styles.
- Accent text uses `AccentTextFillColorPrimaryBrush`. Text on an accent
  fill uses `TextOnAccentFillColorPrimaryBrush`, never a fixed white.
- Style controls with `Style` and, when needed, a `ControlTemplate` copy
  with every visual state. Never rebuild a control from shapes: it loses
  the keyboard, focus, and Narrator.
- Inner corners are concentric: inner radius = outer radius - inset.
- Every animation goes through `Motion`, so "Animation effects" off and a
  per-feature "Full, Fast, Off" setting apply everywhere.
- Search results and switchers do not animate. Speed wins.
- Pointer hover never moves a selection. Only a click or a key does.
- Units ("KB/s", "%") never animate. Only the number does.
- Never animate a page's first layout. Overlays wait one frame, then fade
  and scale in over 167 ms.
- One accent button per page or dialog.

## 5. Migrate

Replace raw values screen by screen, one commit per screen. After each,
build and snapshot (`build-and-verify` skill). The screen looks the same
or better, never worse.

## 6. Point agents at it

Add one line to the app's `CLAUDE.md`: "Design rules:
`design/DESIGN-SYSTEM.md`. Use its tokens; never raw colors, radii, or
durations."

Done when this finds no hits outside the token files:

```powershell
Get-ChildItem src -Recurse -Include *.xaml,*.cs |
  Where-Object { $_.Name -notmatch '^(Theme\.cs|Space\.xaml|Grid\.cs|Surfaces\.xaml|Radius\.xaml|Motion\.cs|Tokens\.(xaml|cs))$' } |
  Select-String -Pattern '#[0-9A-Fa-f]{6,8}\b|Color\.FromArgb|Colors\.(White|Black|Gray)|CornerRadius="\d|Duration="0:0:'
```

(hex strings in data and comments are fine), and DESIGN-SYSTEM.md has a
section for every token file.
Pliki w paczce (2)
  • SKILL.md 7 KB
  • agents/openai.yaml 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · daveebbelaar/bawa100MIT
frontic/ui100MIT
akillness/jeo-skills100MIT
langwatch/langwatch100Apache-2.0
borghei/Claude-Skills100MIT
alirezarezvani/claude-skills100MIT
sallaumen/elixir-agent-kit100MIT
davidelarocca/swift-harness100MIT
nextlevelbuilder/ui-ux-pro-max-skill100MIT

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

  • 100flutter-design-system
    Tworzy i porządkuje system designu aplikacji Flutter: tokeny, kolory, typografię i wspólne komponenty w pliku DESIGN.md.
  • 100color-picker
    Tworzy tymczasowy pływający selektor kolorów do wyboru jednego koloru, a potem stosuje go i usuwa rusztowanie.
  • 100dh-build-design-system
    Buduje system designu z interfejsu, który aplikacja już ma: wyciąga tokeny, dodaje stany komponentów i zamienia kolory na tokeny.
  • 85form
    Działa jako projektant wizualny: tożsamość marki, systemy kolorów, typografia, tokeny designu i projekt UI.
  • 100mobile-design-brief
    Wybiera wygląd aplikacji React Native lub Expo przed budową ekranów: kolor akcentu, skalę typografii, trasy i stany ładowania.
  • 95code-apps-design-guide
    Tworzy przewodnik po designie aplikacji zgodny z marką, zanim powstanie aplikacja: tokeny, kolory, typografię i odstępy.

Uwagi i zgłoszenia

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