К основному содержанию
скилл CX Codex

design-system · daveebbelaar — скилл для Claude Code: дизайн-система macOS

Скилл design-system для Claude Code собирает дизайн-систему macOS-приложения из цветовых и интерфейсных токенов. Он подключается при настройке акцентного цвета, тем или общих правил для экранов.

MIT 1 000 установок ★ 1 933 обновлён 2026-11-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add daveebbelaar/bama --skill design-system -a claude-code
Открыть на GitHub

Что делает design-system

Скилл помогает задать акцентный цвет и оформить дизайн-систему macOS-приложения. Он предлагает хранить значения в Swift-токенах и описывать правила их применения в design/DESIGN-SYSTEM.md, чтобы экраны использовали общие цвета, отступы, радиусы и анимации.

Для готового приложения он предлагает пройти по экранам, собрать жёстко заданные значения и заменять их токенами по одному экрану за коммит. После каждого изменения проект собирают и проверяют снимком экрана. Акцент выбирают по docs/BRIEF.md; если цвет там не назван, остаётся системный акцент macOS.

В примере используются Theme.swift, AppearanceSettings.swift и другие Swift-файлы в Sources/<App>/UI/. Скилл также описывает правила для контрастных цветов, Reduce Motion и системных элементов управления. Для установки через Claude Code нужна команда npx.

Какие задачи решает

  • собрать цветовые и интерфейсные токены для macOS-приложения
  • заменить жёстко заданные значения на общие токены по экранам
  • описать, когда применять каждый токен, в design/DESIGN-SYSTEM.md
  • согласовать анимации и режим Reduce Motion между экранами

Примеры запросов агенту

  • Настрой дизайн-систему для этого macOS-приложения.
  • Собери токены и правила для экранов в design/DESIGN-SYSTEM.md.
  • Добавь выбор акцентного цвета в настройки приложения.

Как установить design-system

1Через Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill design-system -a claude-code

2Вручную: положить файлы

~/.claude/skills/design-system/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/design-system/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о design-system

Как установить design-system в Claude Code?

Выполни npx skills add daveebbelaar/bama --skill design-system -a claude-code. Файл скилла устанавливается в ~/.claude/skills/design-system/SKILL.md.

Что делает design-system?

Помогает оформить акцентный цвет и дизайн-систему macOS-приложения: хранить значения в Swift-токенах и описывать правила их использования в design/DESIGN-SYSTEM.md.

Как скилл выбирает акцентный цвет приложения?

Он предлагает свериться с разделом Look в docs/BRIEF.md. Если цвет не задан, используется системный акцент macOS; пользовательский выбор в настройках остаётся доступен.

Исходный текст

SKILL.md · MIT
---
name: design-system
description: Accent color and design system for a macOS app, from the app's accent and the accent picker in Settings to Swift tokens in code 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 `mac-design`. Tokens cover only what the system does not:
the accent, custom surfaces, radii, motion, overlays, and custom controls.

The app keeps Apple's look. Only the accent color changes. For parts of
your own (a custom sidebar, 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 `Sources/<App>/UI/`:

- `Theme.swift`: the accent colors (`Theme.all`), the saved choice
  (`ThemeStore`), the tokens `Palette.accent`, `Palette.accentText`,
  `Palette.onAccent`, and `.themed()`, which tints every scene.
- `AppearanceSettings.swift`: Settings > Appearance, where people pick the
  accent. Light and dark mode follow the Mac. Apple advises against an
  app-specific mode setting; add a System/Light/Dark picker only when the
  owner asks for one, with System as the default. [HIG Dark Mode]
- `Grid.swift`: 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 color the person set for their Mac.

For a brand color, set `ThemeStore.brand` to a `Theme` with three shades:
`light` (accent text in dark mode), `base` (fills and tint), and `deep`
(accent text in light mode). Set `darkText: true` when white text on
`base` is hard to read (yellow, mint, cyan). Keep
`ThemeStore.defaultID = "system"`. The brand then shows only while the
Mac's accent is Multicolor, as in Apple's apps. Any other accent the person
chose for their Mac wins, and so do sidebar icons, which people expect in
their own accent. [HIG Color, Sidebars]

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

To compare colors, take snapshots with `APP_ACCENT=<id>` for two or three
of them and show the user the PNGs. Keep the picker in Settings, so people
can still choose their own color.

Check: `ThemeStore.defaultID` is "system", and the snapshots show the
accent on buttons, toggles, and selection in light and dark mode.

## 2. Collect

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

Existing app: read every view. List each raw value you find: hex colors, opacities,
corner radii, paddings, frame widths, animation durations and curves,
custom button 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.swift`. The rest get one file per group in
`Sources/<App>/UI/`. Add each token when the app first needs it:

| File | Holds |
| --- | --- |
| `Theme.swift` | the accents, `ThemeStore`, `.themed()`, and `Palette`: `accent`, `onAccent` (text and symbols on accent fills), `accentText` (accent-colored text: deep shade in light mode, light shade in dark mode) |
| `Grid.swift` | the spacing scale (`Space`) and the layout probes |
| `Surfaces.swift` | `surface`, `surfaceHover`, `hairline`, one warning color |
| `Radius.swift` | `xs 6` chips and key caps, `sm 8` controls, `row 10` row hover fills, `md 12` cards, `lg 18` widgets, `xl 26` floating glass |
| `Layout.swift` | `contentWidth`, fixed column and sheet widths |
| `Motion.swift` | `hover`, `quick` (presses, small flips), `ui`, `select` (selection moving through a live list), `appear`, `dismiss`, `glide`, `numberRoll`, `listChange`, loops (`pulse`) that stop under Reduce Motion |
| `Components.swift` | more control styles: `HoverButtonStyle`, `.hoverFill`, toggles, chips |
| `Overlay.swift` | one panel builder, one entrance, one exit |

Surfaces adapt to light and dark. Views read the accent through `.tint` or
`Palette`, so a new choice in Settings redraws the whole app.

## 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 `.tint` or `Palette.accent`.
- Every custom color has four values: light, dark, and a stronger one of
  each for Increase Contrast (`Color(light:dark:highContrastLight:highContrastDark:)`
  in `Theme.swift`). [HIG Color]
- Never redefine or copy a semantic color (`.separator` as text, a label
  color as a fill). Their values change per release.
- A custom surface in its neutral state is a little translucent, so it
  picks up the desktop tint like system surfaces. A colored state is
  opaque.
- A custom font only for headings. Body and captions stay in the system
  font, and every custom font has a bold weight for the Bold Text setting.
- Accent-colored text uses `Palette.accentText`. Text on an accent fill
  uses `Palette.onAccent`, never a fixed white.
- Style controls with `ButtonStyle` and `ToggleStyle`. Never rebuild a
  control from shapes: it loses the keyboard, focus, and VoiceOver.
- Inner corners are concentric: inner radius = outer radius - inset.
- Every animation goes through `Motion`, so a per-feature "Full, Fast,
  Off" setting and Reduce Motion apply everywhere.
- Search results and switchers do not animate. Speed wins.
- Hover never moves a selection. Only a click or a key does.
- Units ("KB/s", "%") never animate. Only the number does
  (`.contentTransition(.numericText())`).
- Never animate a view's first layout. Overlays wait one frame, then
  animate opacity, scale, and a few points of travel.
- Leave room around glass for its shadow (about 3 times the shadow radius).
- One primary button per page or card.

## 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` (create the file if it is missing):
"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:

```bash
grep -rnE 'cornerRadius: [0-9]{1,2}\b|duration: [0-9]|\.spring\(response|\.snappy\b|\.easeInOut|\.easeOut\(|Color\(hex:|Color\(red:' Sources/ \
  | grep -v 'Path(roundedRect'
```

(hex strings in data and comments are fine), and DESIGN-SYSTEM.md has a section
for every token file.

© daveebbelaar · MIT · daveebbelaar/bama

Похожие скиллы

Все скиллы по теме «Дизайн» →

Сначала — design-system от других авторов.

design-system claudekit Скилл design-system для Claude Code собирает дизайн-токены, спецификации компонентов и презентационные слайды. Объединяет интерфейс и слайды общей дизайн-системой. CX Codex +1 54 500установок design-system affaan-m Скилл design-system собирает дизайн-систему из существующей вёрстки или проверяет её на визуальную консистентность: токены, оценка по десяти критериям, поиск шаблонных ИИ-приёмов. CX Codex +1 6 800установок design-system официальный anthropics Проверяет дизайн-систему на несоответствия, документирует компоненты и проектирует новые паттерны. Запускается одной командой /design-system audit, document или extend. CX Codex +1 4 700установок design-system Donchitos Скилл design-system для Claude Code и других агентных сред. Ведёт по секциям GDD одной игровой системы, проверяет связи с зависимостями и удерживает документ от расползания. CX Codex +1 731установок design-system jezweb Скилл design-system для Claude Code и Codex разбирает сайт или скриншот и собирает из него семантическую дизайн-систему в файл DESIGN.md. Повторяет чужой визуальный язык в новом проекте. CX Codex +1 1 200установок extract-design-system arvindrk Скилл extract-design-system находит базовые токены дизайна на веб-странице и создаёт начальные файлы tokens.json и tokens.css. Он полезен для быстрого старта стилизации в новом репозитории. CX Codex +1 131 800установок tailwind-design-system Seth Hobson Скилл tailwind-design-system для Claude Code помогает создавать дизайн-системы на Tailwind CSS v4. Используется для создания библиотеки компонентов и унификации интерфейса проекта. CX Codex +1 70 180установок expo-design-system expo Скилл expo-design-system помогает выстроить дизайн-систему в приложении на Expo: организовать токены, вынести общие компоненты и убрать расхождения в стилях. CX Codex +1 22 700установок design-system-patterns Seth Hobson Скилл design-system-patterns для Claude Code, Codex и Cursor с паттернами архитектуры дизайн-систем: токены, темизация, компонентные библиотеки. Включается при создании токенов, переключении тем и закладке фундамента UI. CX Codex +1 15 953установок stitch::manage-design-system официальный google-labs-code Скилл stitch::manage-design-system для Claude Code собирает дизайн-систему в Stitch и применяет её к экранам. Он включается при создании или обновлении дизайн-токенов проекта. CX Codex +1 11 900установок figma-create-design-system-rules официальный openai Скилл figma-create-design-system-rules для Claude Code, Codex, Cursor и других агентов генерирует правила дизайн-системы под конкретный проект. CX Codex +1 3 200установок

Из того же набора21

Весь набор →
layout-grid Скилл layout-grid для Claude Code проверяет сетку и выравнивание в приложениях macOS SwiftUI. Запускается при создании кастомных экранов, карточек, форм и после изменения вёрстки. CX Codex +1 1 000установок user-stories Скилл user-stories для Claude Code, который превращает описание приложения в бэклог пользовательских историй с проверяемыми критериями. CX Codex +1 1 000установок swift-swiftui Скилл swift-swiftui для Claude Code задаёт правила Swift 6 и SwiftUI для приложений macOS. Подключается при написании, проверке и отладке Swift-кода, в том числе при ошибках конкуренции и Sendable. CX Codex +1 1 000установок design-kit Скилл design-kit для Claude Code и Cursor собирает дизайн-систему для macOS SwiftUI на токенах и компонентах. Включается, когда нужна своя тема интерфейса, фирменный стиль или библиотека элементов. CX Codex +1 1 000установок new-mac-app Скилл new-mac-app для Claude Code создаёт нативное macOS-приложение на SwiftUI из готового шаблона. Он запускается, когда нужен новый проект или каркас приложения. CX Codex +1 1 000установок test-mac-app Скилл test-mac-app для Claude Code помогает проверять macOS-приложение на нескольких уровнях — от Swift-тестов до управления запущенной программой. Активируется при добавлении логики, исправлении ошибок и проверке перед релизом. CX Codex +1 1 000установок ux-design Скилл ux-design для Claude Code проводит UX-проверку фичи macOS-приложения перед написанием кода, охватывая термины, сценарии, выбор поверхности и доступность. Запускается перед кодингом задачи со скрином, действием или текстом. CX Codex +1 1 000установок bama Скилл bama для Claude Code помогает выбрать следующий этап разработки нативного приложения для macOS. По запросу он направляет работу от идеи и исследования до сборки и проверки приложения. CX Codex +1 1 000установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой