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

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

Скилл team-ux для Claude Code составляет UX-спецификации интерфейсов без кода: описывает сценарии экранов, состояния, доступность по WCAG 2.1 AA и поведение на мобильных устройствах.

MIT ★ 71 обновлён 2026-11-13

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

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

Скилл формирует подробные UX-спецификации в формате Markdown. Он запрещает писать код или подбирать hex-цвета, концентрируясь на пользовательских путях и поведении интерфейса. Каждый шаг сценария фиксирует, какое действие доступно пользователю и какое решение он принимает.

В спецификацию обязательно включается инвентарь экранов с пятью состояниями: загрузка, пустой экран, ошибка, заполненный контент и отказ в доступе. Скилл также составляет каталог повторно используемых компонентов и проверяет макеты по правилам доступности WCAG 2.1 AA — от контрастности 4.5:1 и клавиатурной навигации до тач-таргетов размером не менее 44x44 px. Отдельно описывается адаптация под экраны уже 768 px и микротексты кнопок с понятными системными сообщениями.

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

  • составить спецификацию пользовательских сценариев для новых экранов
  • описать обязательные состояния экранов: пустой, ошибка, загрузка и доступ
  • проверить интерфейс на соответствие требованиям доступности WCAG 2.1 AA
  • определить правила адаптации таблиц, форм и модальных окон для экранов меньше 768 px

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

  • Напиши UX-спецификацию для экрана оформления заказа в интернет-магазине
  • Опиши все состояния и микрокопию для формы сброса пароля
  • Составь чеклист доступности WCAG 2.1 AA для модального окна фильтров

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

1Через Skills CLI (Vercel)

npx skills add sametcelikbicak/opencode-team --skill team-ux -a claude-code

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

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

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

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

Вопросы о team-ux

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

Выполните команду npx skills add sametcelikbicak/opencode-team --skill team-ux -a claude-code в терминале или сохраните файл по пути ~/.claude/skills/team-ux/SKILL.md.

Что делает скилл team-ux?

Он генерирует текстовое UX-описание продукта в Markdown: структуру переходов, инвентарь компонентов, все состояния экранов, правила адаптивности и тексты для кнопок и ошибок.

Какие требования к доступности учитывает team-ux?

Скилл проверяет соблюдение стандарта WCAG 2.1 AA: навигацию с клавиатуры, видимый фокус, контрастность 4.5:1, тач-таргеты от 44x44 px, ARIA-атрибуты и системные настройки уменьшения движения.

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

SKILL.md · MIT
---
name: team-ux
description: UX design specification writing. Screen flows, state inventory, component list, accessibility and mobile behavior. The playbook of the ux role.
---

# UX Design Specification

You are writing a **specification**, not pixels. Implementation details are the developer's job.

## 1. Main flow

For each flow:

```
Flow: <what they want to do>
1. <screen> — what the user sees, what they can do, what decision they make
2. <screen> — ...
3. <result screen>
```

Each step must answer "what can the user do here?". If there is no answer, the step is unnecessary.

## 2. Screen inventory

| Screen | Purpose | Entry | Exit | States |
|---|---|---|---|---|

**The states column is mandatory for every screen:**

| State | What is shown | What can be done |
|---|---|---|
| Loading | skeleton loader | cancel |
| Empty | text explaining what to do + a primary action | trigger the action |
| Error | what happened + what will happen | try again / support |
| Populated | the content | interact with the content |
| Unauthorized | access denied + why | go back / support |

The empty state is the most frequently forgotten one and the most expensive one: the user meeting an empty screen on first open kills the product.

## 3. Component inventory

| Component | Where it is used | States | Note |
|---|---|---|---|

If the same button style was copied in three places, it should be a single component. Every repeated interface piece goes in here.

## 4. Accessibility (WCAG 2.1 AA)

Check for each screen:

- **Keyboard**: all interactive elements are keyboard reachable, the tab order is logical, when a modal opens the focus stays inside and Esc closes it.
- **Focus**: a visible focus ring (do not remove it). When the page changes, focus moves to the top.
- **Contrast**: text 4.5:1, large text and icons 3:1.
- **Screen reader**: meaningful `aria-label`, `role`, `aria-live` (for state changes), form errors linked with `aria-describedby`.
- **Color does not carry meaning alone**: an error is not only red, it also has an icon + text.
- **Motion**: `prefers-reduced-motion` is supported.
- **Touch target**: at least 44x44 px.

## 5. Mobile behavior

- Screen < 768px: which components are hidden, which are rearranged?
- Table: horizontal scroll or cards?
- Modal: full screen?
- Form: single column or grouped?
- Is there a bottom navigation, and how many items?

## 6. Tone and microcopy

- Button text: names the action ("Save Invoice", "Send", not "OK").
- Error message: what happened + what to do ("The invoice could not be uploaded. The file must be smaller than 10 MB.")
- Empty state text: what will happen ("You have no invoices yet. Upload your first invoice" + button).
- Confirmation: is it reversible, or not?

## Common mistakes

| Mistake | The right way |
|---|---|
| Giving color codes | Define hierarchy and behavior |
| Only the "happy path" | Empty/error/loading/unauthorized are mandatory |
| Skipping the error state | Show errors on every form field |
| Thinking about accessibility later | An AA check for every screen |
| "John Doe" sample data | Realistic, localized sample data |

## Output format

Markdown. Sections: Main flow / Screen inventory / Component inventory / Accessibility notes / Mobile behavior / Microcopy.

In the user's language (Turkish or English).

© sametcelikbicak · MIT · sametcelikbicak/opencode-team

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

Все скиллы по теме «Дизайн» →
ui-ux-polish oakoss Скилл ui-ux-polish для итеративной доводки интерфейса веб-приложения: отдельно десктоп и мобильные, паттерны вроде glassmorphism и проверка доступности. CX Codex +1 577установок product-ux-expert majiayu000 Скилл product-ux-expert для проверки интерфейсов по эвристикам Нильсена, построения карт пути пользователя и аудита доступности по WCAG 2.2 AA. CX Codex +1 212установок bencium-controlled-ux-designer bencium Скилл bencium-controlled-ux-designer помогает обсуждать визуальные решения для веб-интерфейсов до правок кода. Пригодится при создании компонентов, страниц и приложений. CX Codex +1 5 100установок ux-design Mindrally Скилл ux-design для Claude Code и пяти других платформ задаёт агенту правила UX-проектирования: от исследования пользователей до доступности и адаптивной вёрстки. Проектирует экран или разбирает существующий интерфейс. CX Codex +1 1 200установок design-review plugin87 Скилл design-review для Claude Code проводит аудит интерфейса по шести взвешенным метрикам и эвристикам Нильсена. Включается при запросе дизайн-критики, оценки качества экрана или проверки доступности. CX Codex +1 694установок ui-design PyModel Скилл ui-design для Claude Code задаёт 42 правила фронтенд-дизайна в 8 категориях: от доступности WCAG и Core Web Vitals до анимаций. CX Codex +1 655установок

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

Весь набор →
orchestrator Субагент orchestrator для Claude Code ведёт идею по этапам от исследования до запуска. Он распределяет работу между специалистами и ждёт подтверждения перед переходом дальше. CX Codex ★ 71звёзд репо team-docs Скилл team-docs для Claude Code задаёт методику написания технической документации. Он включается при подготовке README, руководств по использованию, документации API и заметок об архитектуре. CX Codex +1 ★ 71звёзд репо team-prd Скилл team-prd для Claude Code структурирует составление продуктовых требований к первой версии продукта. Задаёт границы скоупа и проверяемые критерии приёмки. CX Codex +1 ★ 71звёзд репо team-qa Скилл team-qa для Claude Code превращает критерии приёмки в тесты и задаёт стратегию QA. Он помогает проверить граничные случаи, основные пользовательские сценарии и найденные баги. CX Codex +1 ★ 71звёзд репо team-marketing Скилл team-marketing для Claude Code помогает спланировать маркетинг и запуск продукта: от позиционирования до календаря публикаций. Он подключается к задачам по подготовке сообщений, каналов продвижения и измеримых метрик. CX Codex +1 ★ 71звёзд репо team-market-research Скилл team-market-research для Claude Code проводит исследование рынка, конкурентов и аудитории. Включается при разборе ниши, проверке гипотезы продукта или анализе рисков. CX Codex +1 ★ 71звёзд репо team-architecture Скилл team-architecture для Claude Code помогает спроектировать архитектуру приложения: от модели данных и API до границ модулей и рисков. Подключается к запросам на техническое проектирование. CX Codex +1 ★ 71звёзд репо team-security-review Скилл team-security-review для Claude Code проводит аудит безопасности кодовой базы. Он проверяет аутентификацию, права доступа, валидацию данных и утечки секретов. CX Codex +1 ★ 71звёзд репо

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

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