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

design-kit — скилл для Claude Code: что делает и как установить

Скилл design-kit для Claude Code и Cursor собирает дизайн-систему для macOS SwiftUI на токенах и компонентах. Включается, когда нужна своя тема интерфейса, фирменный стиль или библиотека элементов.

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

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

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

Скилл проектирует дизайн-систему для macOS SwiftUI с нуля, используя три слоя токенов, шрифты, иконки и элементы управления. Агент пишет спецификацию в design/KIT.md, раскладывает токены по файлам, настраивает шрифты и оформляет галерею компонентов для проверки состояний.

Код компонентов размещается в Sources/<App>/DesignKit/. Перед сборкой проверяются правила стилей через шелл-скрипты и grep, а галерея запускается при переменной окружения APP_KIT_GALLERY=1.

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

  • создать спецификацию дизайн-системы для приложения
  • организовать токены в три слоя по палитре и смыслу
  • собрать компоненты интерфейса со всеми состояниями
  • настроить галерею элементов для проверки верстки

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

  • Собери дизайн-систему для SwiftUI-приложения по шагам
  • Опиши токены и компоненты в дизайн-ките
  • Добавь галерею компонентов для проверки состояний интерфейса

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о design-kit

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

Выполните команду npx skills add daveebbelaar/bama --skill design-kit -a claude-code в терминале, затем обратитесь к файлу ~/.claude/skills/design-kit/SKILL.md.

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

Скилл настраивает собственную дизайн-систему для macOS на SwiftUI, охватывая палитру, шрифты, иконки и интерактивные состояния элементов управления.

Что нужно для работы design-kit?

Для работы требуется проект на macOS SwiftUI и настроенный ИИ-ассистент с поддержкой скиллов.

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

SKILL.md · MIT
---
name: design-kit
description: Custom design system for a macOS SwiftUI app with its own parts, not Apple's, covering three token layers, type, an icon set, every part in every state, custom window chrome, a parts gallery, and checks. Use when the user wants the app to have its own look and feel, a brand, or custom buttons, rows, and sidebars, when design-from-app has measured a reference app, or when the user asks for a design system or component library.
---

# Design kit

A native look comes from Apple's parts. A custom look comes from your own
parts: your sidebar row, your button, your checkbox, your icons. SwiftUI
draws all of them. A kit is those parts, the numbers behind them, and one
page that shows every part in every state.

Most apps keep Apple's parts and only pick an accent color (`design-system`
skill). Build a kit when the parts themselves must change. To copy the look of an existing app,
call the Skill tool with `design-from-app` first: it measures the app and
then comes back here.

Everything lives in `Sources/<App>/DesignKit/`. Code for every step:
[parts.md](parts.md).

## 1. Write the spec

Write `design/KIT.md` from [kit-spec.md](kit-spec.md): three words for the
feel, the tokens, the type scale, the icon rules, and one section per part
with its sizes and states. Agents build from this page and review against it.

Check: every part the app's screens need has a section with its sizes and
its states.

## 2. Tokens in three layers

`DesignKit/Tokens.swift`:

1. **Palette**: raw colors, named by hue and step (`gray50`, `blue600`).
   Only this file reads it.
2. **Meaning**: `Ink.text`, `Ink.accent`, `Ink.selection`, `Ink.divider`,
   with a light and a dark value each. Parts read only this layer.
3. **Scales**: `KitType` (type roles), `Metric` (sizes), `Motion`
   (named intents like `hover` and `check`).

A rebrand changes the palette. A dark mode fix changes the meaning layer.
Neither touches a part.

Check: `grep -rn 'Palette\.' Sources/ | grep -v Tokens.swift` finds nothing.

## 3. Type

Name styles by role (`title`, `body`, `label`, `section`, `meta`), never
by size. Use the system font unless the brand needs its own; a bundled
font goes in `Resources/Fonts/` with `ATSApplicationFontsPath` in
`Info.plist.in`. Half-point sizes are fine when a reference needs them.

Check: views set fonts only through `.kitType(...)`.

## 4. Icons

Icons decide the feel more than color does. Views name a `KitIcon`, never
an SF Symbol or a file, so the whole set can change in one place.

- Start from SF Symbols at a fixed size and weight. Light weights read
  less like Apple.
- For a set of your own, draw each icon as a SwiftUI `Shape` from its SVG
  path, or make custom symbols in the SF Symbols app.
- One size, one stroke weight, one corner style for the whole set.
- A selected row may switch to the filled form.

Check: `grep -rn 'systemName:' Sources/ | grep -v DesignKit/` finds nothing.

## 5. Parts

One file per family in `DesignKit/Components/`: sidebar, rows, buttons,
fields, menus. Each part:

- Is a real control. Style a `Button` with a `ButtonStyle`, a `Toggle`
  with a `ToggleStyle`, a field with a `TextFieldStyle`. Never a shape with
  a tap gesture: it loses the keyboard, focus, and VoiceOver.
- Has every state: rest, hover, pressed, selected, focused, disabled, in
  light and dark. Hover uses `onHover`, pressed uses
  `configuration.isPressed`, disabled reads `isEnabled`.
- Takes a forced state for the gallery, so hover and pressed show up in a
  snapshot.
- Reads only meaning tokens, `KitType`, `Metric`, `Motion`, and `KitIcon`.

Check: the part matches its section in `design/KIT.md` in every state.

## 6. Window chrome

For a fully custom look, hide the title bar and draw your own top bar,
and build the sidebar from kit rows instead of `List`. Keep the traffic
lights, menus, context menus, sheets, and alerts native: users depend on
them. SwiftUI cannot move the traffic lights; a small `NSViewRepresentable`
reaches the `NSWindow` (parts.md, Window chrome).

A custom sidebar matches the macOS 27 system one where people would
notice: the selected row's text turns semibold, the selection fill dims
when the window is inactive (`@Environment(\.appearsActive)`), and row
corners stay concentric with the sidebar (mac-design patterns.md, "Custom
chrome that follows the window"). Custom glass bounces on click only on
controls.

Check: the window opens at its default size, the traffic lights sit where
the spec says, the custom sidebar moves with the arrow keys, and its
selection dims when another window is in front.

## 7. Gallery

`DesignKit/KitGallery.swift` shows every part in every state, in light and
dark, the way a storybook does. The app shows it instead of its pages when
`APP_KIT_GALLERY=1` is set, so the normal snapshot command captures it.
Review a new part here before it goes into a screen.

Check: the gallery snapshot shows every part from `design/KIT.md`, and the
user has seen it.

## 8. Checks

```bash
tools/grid-lint.sh
grep -rnE 'Color\(hex|Color\(red|\.font\(\.system|systemName:' Sources/ | grep -v DesignKit/
```

Both come back clean. Then build, snapshot, and run the `layout-grid`
checks on the screens (`build-and-verify` skill).

Done when `design/KIT.md` covers every part, every part is a real control
with every state, the gallery shows them all in light and dark, and the
checks above come back clean.

© daveebbelaar · MIT · daveebbelaar/bama

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

Все скиллы по теме «Дизайн» →
liquid-glass официальный OpenAI Помогает внедрить оформление Liquid Glass в приложениях на macOS SwiftUI и убрать самодельные фоны, мешающие системным материалам. CX Codex GP ChatGPT +1 78установок window-management официальный OpenAI Скилл window-management помогает настраивать окна и сцены SwiftUI в macOS 15+: убирать лишний хром, задавать области перетаскивания, правила размещения и восстановления. CX Codex GP ChatGPT +1 58установок otto-design maxtrigify Скилл otto-design для Claude Code задаёт процесс проектирования интерфейсов Otto в Paper перед сборкой в SwiftUI. Включается при запросах на мокапы, редизайн или изменение экранов и карточек приложения. CX Codex +1 ★ 141звёзд репо swiftui-patterns podo Скилл swiftui-patterns для Claude Code описывает архитектурные практики SwiftUI: настройку TabView, навигацию, модификаторы представлений и управление состоянием через @State и @Binding. CX Codex +1 205установок swiftui-design-skill wholiver Скилл swiftui-design-skill помогает проектировать экраны SwiftUI для iOS и macOS без шаблонного визуала. Пригодится при вёрстке прототипов и подборе дизайн-направления с нуля. CX Codex +1 1 300установок design rshankras Скилл design для Claude Code: набор дизайн-скиллов для интерфейсов Apple — Liquid Glass, анимации, игровой отклик, UX-тексты, SF Symbols и типографика. Выдаёт план правок для плоского интерфейса. CX Codex +1 738установок

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

Весь набор →
os-integrations Скилл os-integrations для Claude Code помогает выбрать API macOS и нужные разрешения для системных функций приложения. Включается при добавлении глобальных горячих клавиш, захвата экрана или управления окнами других приложений. CX Codex +1 1 000установок 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-system Скилл design-system для Claude Code собирает дизайн-систему macOS-приложения из цветовых и интерфейсных токенов. Он подключается при настройке акцентного цвета, тем или общих правил для экранов. 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установок

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

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