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

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

Скилл ux-design для Claude Code проводит UX-проверку фичи macOS-приложения перед написанием кода, охватывая термины, сценарии, выбор поверхности и доступность. Запускается перед кодингом задачи со скрином, действием или текстом.

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

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

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

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

Процесс охватывает проработку состояний пустоты, загрузки, ошибок и завершения, а также формирование текстов кнопок, подсказок и доступности для VoiceOver. Результат фиксируется в файлах документации проекта в виде блока проверки и новых терминов.

Для работы требуется репозиторий с историей задач и файлами описания интерфейса. Применение скилла помогает выстроить единообразный интерфейс без путаницы в терминах и действиях пользователя.

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

  • описать сценарий взаимодействия для новой фичи в одну строку
  • составить глоссарий терминов и действий для приложения
  • подобрать тип интерфейсной поверхности для экрана
  • проверить состояния загрузки, ошибок и пустого экрана
  • провести аудит доступности интерфейса с VoiceOver

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

  • Сделай UX-проверку для задачи [story ID]
  • Проверь флоу и названия для нового экрана
  • Обнови глоссарий терминов интерфейса

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы об ux-design

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

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

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

Скилл проводит UX-анализ фичи macOS-приложения до написания кода, определяя названия элементов, сценарии перемещения, выбор поверхности, состояния интерфейса и доступность.

Где сохраняются результаты UX-проверки?

Результаты проверки записываются в блок UX: в файле историй проекта, а новые термины добавляются в глоссарий.

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

SKILL.md · MIT
---
name: ux-design
description: UX pass for one feature of a macOS app, covering names, flow, where it opens (inline, popover, sheet, window, alert), states, words, hover help, accessibility, and AI features. Use before coding a story that adds a screen, an action, or text, when user-stories or improve-loop call it, or when the user asks for a UX review, clearer wording, better names, or whether something should be a modal.
argument-hint: "[story ID or screen]"
---

# UX design

A feature that works can still confuse people. This pass decides what
things are called, how a person moves through the feature, where it opens,
and what it says, before any code exists.

Run it once per story that adds a screen, an action, or words. The output
is a `UX:` block in the story in `docs/STORIES.md`, plus new terms in
`docs/GLOSSARY.md`. To review a built screen, run the same steps against
its snapshot and list what fails, most serious first.

## 0. Read

Read `docs/BRIEF.md`, `docs/GLOSSARY.md` (create it if missing), the story,
and its reference screenshots.

## 1. Name it

Every thing in the app has exactly one name, and every name lives in the
glossary.

```markdown
| Term | Means | Not |
| --- | --- | --- |
| Task | One thing to do, with an optional due date | to-do, item, entry |
| Complete | Mark a task done; it leaves the list | check, finish, close |
```

- Name the things first (the nouns in the brief), then the actions on them.
- Use the user's words, not the code's: "Task", not "TaskEntity" or "record".
- Use Apple's words for system actions: Settings, Quit, Close, Undo, Move
  to Trash (when it can come back), Delete (when it cannot).
- One word per idea across buttons, menus, titles, tooltips, and errors.
- Name a feature for what it does for the person, not the technology. A
  toggle gets a verb phrase that says what and for whom ("Enhance
  Dialogue", not "Isolate Vocals"). Say the name in a sentence out loud.
  Method: [writing.md](writing.md#names).

Check: every noun and verb the story puts on screen is in the glossary,
and no glossary term has a second name anywhere.

## 2. Map the flow

Write the flow as one line, from every way in to a clear end.

```text
Command-N, toolbar +, File > New Task -> title field has focus -> Return saves, row appears -> focus stays for the next task
```

- List every entry point: menu command, shortcut, toolbar, context menu,
  drag and drop.
- Cut steps: fill in good defaults, ask only for what you cannot guess.
- Every step has a way back: Escape cancels, Command-Z undoes.
- The end is visible: the new row, a checkmark, the window closing.

Check: the flow fits on one line, and each step names its way back.

## 3. Pick the surface

Go down this list and use the first one that fits. Lighter is better.

| The feature | Use |
| --- | --- |
| Changes one value on something already on screen | Inline (field, toggle, menu in the row) |
| Shows details of the selection while people keep working | Inspector |
| A few related choices tied to one control | Popover |
| Input people repeat while they watch the result, or a tool kept open beside the work | Panel |
| One short task that must finish or cancel before going on | Sheet |
| A long or self-contained task, or one people keep open beside the main window | New window |
| A place people come back to, like a list or a collection | Sidebar page |
| A rare action that destroys data and cannot be undone | Confirmation dialog |
| A problem people must act on right now | Alert |

- Show one modal at a time. Never open a popover from a popover, or a
  sheet from a sheet.
- A modal's title names its task: "Rename Project", not "Edit".
- Return confirms, Escape cancels, and the confirm button names the action.
- Ask before closing only when people would lose what they typed.
- Information that needs no action goes inline, never in an alert.

Details and SwiftUI code for each surface: [presentation.md](presentation.md).

Check: the `UX:` block names the surface and the table row that picked it.

## 4. Cover the states

Every view the story touches has words and a look for each state:

- **Empty**: what it is for, plus the first action as a button.
- **Loading**: only when it can take longer than half a second. Show
  cached content first. A bar when the length is known, with words for
  what is happening ("Importing 12 photos"), and Cancel when it is safe.
- **Error**: inline, next to the problem, with the fix.
- **Too much**: long names truncate with the full text in a tooltip; a
  thousand rows still scroll smoothly.
- **Done**: visible feedback in the same frame, and Undo where it applies.

Check: each state has a snapshot page or seed data that shows it.

## 5. Write the words

- Buttons and menu items start with a verb: "Add Task", "Export…".
- Add an ellipsis when the command asks for more input before it acts.
- Title case for buttons, menu items, and window titles. Sentence case for
  labels, descriptions, and messages.
- Errors say what happened and how to fix it, without blame. Write
  "Unable to load tasks", never "We're having trouble".
- Confirmations repeat the action: "Delete 3 Tasks?" with buttons "Delete"
  and "Cancel", never "Yes" and "No".

Patterns and before and after examples: [writing.md](writing.md).

A feature that uses AI (a summary, generated text, a model's suggestion)
also follows [ai-features.md](ai-features.md).

Check: read every string aloud. Each one is short, uses glossary terms
only, and a new user could say what each button does.

## 6. Add hover help

- Every icon-only button gets `.help("Add a task to this list (⌘N)")`:
  what it does, starting with a verb, then its shortcut. Not its name
  again. Rules: [writing.md](writing.md#tooltips).
- Hover can reveal secondary actions on a row. The same actions are also in
  the context menu and on the keyboard.
- Hover feedback shows at once and never shifts the layout.
- Information people need is always visible. Hover only adds detail.

Check: hover every icon-only control on the snapshot build. Each one shows
a tooltip.

## 7. Check accessibility

- The whole flow works with the keyboard alone, in a logical focus order.
- VoiceOver reads every control with the same words as the screen.
- Meaning never rests on color alone: add an icon or a word.
- Text is 10 pt or larger and readable in Increase Contrast.
- Reduce Motion replaces slides and bounces with fades.
- Every custom control has a label, a value, actions, and feedback.

The audit steps and SwiftUI modifiers: [accessibility.md](accessibility.md).

Check: you ran the flow keyboard-only and with VoiceOver, and the
Accessibility Inspector audit shows no issues for the new views.

## 8. Write the UX block

Add the result under the story's acceptance lines:

```markdown
UX:
- Flow: Command-N, toolbar +, File > New Task -> title field -> Return saves -> focus stays
- Surface: inline row at the top of the list (changes one value on screen)
- States: empty "No Tasks" with "Add Task"; error "Give the task a title." under the field
- Words: "Add Task", tooltip "Add a task to this list (⌘N)", "Undo Add Task"
- Access: Return saves, Escape cancels; VoiceOver "New task title"
```

Done when the story has a `UX:` block, every term it uses is in
`docs/GLOSSARY.md`, and steps 1 to 7 pass on its snapshots.

© daveebbelaar · MIT · daveebbelaar/bama

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

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

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

ux-design Donchitos Скилл ux-design для Claude Code посекционно составляет UX-спецификации игровых экранов, HUD и требований доступности. Помогает геймдевелоперам проектировать интерфейсы. CX Codex +1 687установок ux-design Mindrally Скилл ux-design для Claude Code и пяти других платформ задаёт агенту правила UX-проектирования: от исследования пользователей до доступности и адаптивной вёрстки. Проектирует экран или разбирает существующий интерфейс. CX Codex +1 1 200установок ios-ux-design mosif16 Скилл ios-ux-design, который подключает к ИИ-агенту экспертизу по Human Interface Guidelines и SwiftUI: аудит экранов, разбор паттернов, спецификации на доработку. CX Codex +1 549установок ios-hig-design wondelai Скилл ios-hig-design для Claude Code и других платформ проектирует нативные iOS-интерфейсы по Human Interface Guidelines Apple. Покрывает Safe Areas, типографику, цвет, навигацию и SF Symbols. CX Codex +1 9 200установок frontend-design PracticalSwan Скилл frontend-design для Claude Code, Codex, Cursor и других платформ: проектирует и реализует фронтенд-интерфейсы с учётом задачи, контента и аудитории. CX Codex +1 241установок ai-design-check Enmera Software Плагин ai-design-check для Claude Code проверяет экраны, собранные ИИ, и помогает убрать сгенерированный вид. Запускается по запросу «исправь дизайн этого экрана». CX Codex ★ 277звёзд репо modern-web-design Claude Design Skillstack Плагин modern-web-design для Claude Code помогает проектировать сайты, интерактивные интерфейсы и дизайн-системы. Подключается к задачам по доступности, производительности и современным визуальным приёмам. ★ 1 428звёзд репо design-brief Owl-Listener Скилл design-brief формирует бриф проекта с описанием проблемы, аудитории, ограничений и метрик успеха. Пригодится на старте отдельной задачи. CX Codex +1 2 500установок

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

Весь набор →
design-kit Скилл design-kit для Claude Code и Cursor собирает дизайн-систему для macOS SwiftUI на токенах и компонентах. Включается, когда нужна своя тема интерфейса, фирменный стиль или библиотека элементов. 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установок bama Скилл bama для Claude Code помогает выбрать следующий этап разработки нативного приложения для macOS. По запросу он направляет работу от идеи и исследования до сборки и проверки приложения. CX Codex +1 1 000установок clone Скилл clone для Claude Code исследует существующее приложение и описывает его экраны для пересборки интерфейса. Запускается по просьбе клонировать, заменить или повторить дизайн приложения. CX Codex +1 1 000установок mac-design Скилл mac-design для Claude Code задаёт правила оформления SwiftUI-приложений под macOS 26 и новее. Подключается при создании или ревью окна, боковой панели, меню и экрана настроек. CX Codex +1 1 000установок app-icon Скилл app-icon для Claude Code и Cursor создаёт macOS-иконки приложений в формате Icon Composer через сборку actool и проверку через ictool. CX Codex +1 1 000установок

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

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