Спецификация дизайна для разработчика
По дизайну готовит лист для разработчиков: размеры, токены, состояния кнопок, адаптивность, крайние случаи и анимацию.
- Что делает
- По дизайну готовит лист для разработчиков: размеры, токены, состояния кнопок, адаптивность, крайние случаи и анимацию.
- Когда брать
- Когда дизайн готов и его пора передавать в разработку, чтобы разработчик не угадывал, как должно выглядеть и вести себя.
- Пример запроса
- Подготовь спецификацию для разработчика по этому экрану в Figma, мы используем React и Tailwind.
- Нужно подключить
- Figma, трекер задач
Входит в плагин design. В Cowork и Claude Code можно поставить плагин целиком.
Как включить
- Нажмите «Скачать на русском» и сохраните архив.
- В Claude откройте Настройки → Capabilities → Skills → Upload skill и выберите архив.
- Включите скилл переключателем.
Для терминала
Распакуйте архив и положите папку design-handoff в ~/.claude/skills/. Файл SKILL.md должен лежать внутри этой папки.
Текст
---
name: design-handoff
description: Подготовь спецификацию для передачи разработчикам по дизайну. Используй, когда дизайн готов к разработке и нужен технический лист с макетом, дизайн-токенами, свойствами компонентов, состояниями взаимодействия, адаптивными точками перелома, крайними случаями и деталями анимации.
argument-hint: "<Figma URL or design description>"
---
/design-handoff
Если встретишь незнакомые подстановки или нужно проверить, какие инструменты подключены, смотри [CONNECTORS.md](../../CONNECTORS.md).
Подготовь подробную документацию для передачи дизайна разработчикам.
Использование
/design-handoff $ARGUMENTS
Подготовь спецификацию для передачи: @$1
Если указана ссылка на Figma, загрузи дизайн из Figma. В остальных случаях работай по предоставленному описанию или скриншоту.
Что включить
Визуальные спецификации
- Точные размеры (внутренние и внешние отступы, ширина)
- Ссылки на дизайн-токены (цвета, типографика, отступы)
- Адаптивные точки перелома и поведение
- Варианты и состояния компонентов
Спецификации взаимодействия
- Поведение при клике или касании
- Состояния при наведении
- Переходы и анимации (длительность, функция сглаживания)
- Поддержка жестов (смахивание, щипок, долгое нажатие)
Спецификации содержимого
- Ограничения по числу символов
- Поведение при обрезке текста
- Пустые состояния
- Состояния загрузки
- Состояния ошибки
Крайние случаи
- Минимальный и максимальный объём содержимого
- Международный текст (более длинные строки)
- Медленное соединение
- Отсутствующие данные
Доступность
- Порядок фокуса
- Подписи и роли ARIA
- Взаимодействие с клавиатурой
- Озвучивание в программах экранного чтения
Принципы
- Ничего не предполагай — если что-то не указано, разработчик будет угадывать. Указывай всё.
- Используй токены, а не значения — ссылайся на
spacing-md, а не на16px. - Показывай все состояния — по умолчанию, при наведении, нажатое, отключённое, загрузка, ошибка, пустое.
- Объясняй зачем — «Здесь всё сворачивается на мобильных, потому что пользователи в основном работают одной рукой» помогает разработчикам принимать верные решения.
Результат
## Спецификация передачи: [Название функции/экрана]
### Обзор
[Что делает этот экран/функция, контекст пользователя]
### Макет
[Сетка, точки перелома, адаптивное поведение]
### Используемые дизайн-токены
| Токен | Значение | Применение |
|-------|-------|-------|
| `color-primary` | #[hex] | Кнопки призыва к действию, ссылки |
| `spacing-md` | [X]px | Между разделами |
| `font-heading-lg` | [размер/начертание/семейство] | Заголовок страницы |
### Компоненты
| Компонент | Вариант | Свойства | Примечания |
|-----------|---------|-------|-------|
| [Компонент] | [Вариант] | [Свойства] | [Особое поведение] |
### Состояния и взаимодействия
| Элемент | Состояние | Поведение |
|---------|-------|----------|
| [Кнопка призыва к действию] | Наведение | [Фон темнеет на 10%] |
| [Кнопка призыва к действию] | Загрузка | [Индикатор загрузки, отключена] |
| [Форма] | Ошибка | [Красная рамка, сообщение об ошибке ниже] |
### Адаптивное поведение
| Точка перелома | Изменения |
|------------|---------|
| Компьютер (>1024px) | [Основной макет] |
| Планшет (768-1024px) | [Что меняется] |
| Телефон (<768px) | [Что меняется] |
### Крайние случаи
- **Пустое состояние**: [Что показывать, когда данных нет]
- **Длинный текст**: [Правила обрезки]
- **Загрузка**: [Скелетон или индикатор]
- **Ошибка**: [Как выглядит состояние ошибки]
### Анимация / движение
| Элемент | Триггер | Анимация | Длительность | Сглаживание |
|---------|---------|-----------|----------|--------|
| [Элемент] | [Триггер] | [Описание] | [мс] | [функция сглаживания] |
### Заметки по доступности
- [Порядок фокуса]
- [Нужные подписи ARIA]
- [Взаимодействие с клавиатурой]
Если подключены коннекторы
Если подключён ~~design tool:
- Бери точные размеры, токены и спецификации компонентов из Figma
- Экспортируй ресурсы и собери полный лист спецификации
Если подключён ~~project tracker:
- Свяжи спецификацию с тикетом на реализацию
- Создай подзадачи для каждого раздела спецификации
Советы
- Поделись ссылкой на Figma — я могу взять оттуда точные размеры, токены и данные о компонентах.
- Упомяни крайние случаи — «Что будет, если элементов 100?» помогает мне описать граничные условия.
- Укажи технологический стек — «Мы используем React + Tailwind» помогает мне дать уместные заметки по реализации.
Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/knowledge-work-plugins/tree/main/design/skills/design-handoff, лицензия Apache-2.0. Изменения: перевод на русский язык.
Оригинал на английском
--- name: design-handoff description: Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details. argument-hint: "<Figma URL or design description>" --- # /design-handoff > If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../../CONNECTORS.md). Generate comprehensive developer handoff documentation from a design. ## Usage ``` /design-handoff $ARGUMENTS ``` Generate handoff specs for: @$1 If a Figma URL is provided, pull the design from Figma. Otherwise, work from the provided description or screenshot. ## What to Include ### Visual Specifications - Exact measurements (padding, margins, widths) - Design token references (colors, typography, spacing) - Responsive breakpoints and behavior - Component variants and states ### Interaction Specifications - Click/tap behavior - Hover states - Transitions and animations (duration, easing) - Gesture support (swipe, pinch, long-press) ### Content Specifications - Character limits - Truncation behavior - Empty states - Loading states - Error states ### Edge Cases - Minimum/maximum content - International text (longer strings) - Slow connections - Missing data ### Accessibility - Focus order - ARIA labels and roles - Keyboard interactions - Screen reader announcements ## Principles 1. **Don't assume** — If it's not specified, the developer will guess. Specify everything. 2. **Use tokens, not values** — Reference `spacing-md` not `16px`. 3. **Show all states** — Default, hover, active, disabled, loading, error, empty. 4. **Describe the why** — "This collapses on mobile because users primarily use one-handed" helps developers make good judgment calls. ## Output ```markdown ## Handoff Spec: [Feature/Screen Name] ### Overview [What this screen/feature does, user context] ### Layout [Grid system, breakpoints, responsive behavior] ### Design Tokens Used | Token | Value | Usage | |-------|-------|-------| | `color-primary` | #[hex] | CTA buttons, links | | `spacing-md` | [X]px | Between sections | | `font-heading-lg` | [size/weight/family] | Page title | ### Components | Component | Variant | Props | Notes | |-----------|---------|-------|-------| | [Component] | [Variant] | [Props] | [Special behavior] | ### States and Interactions | Element | State | Behavior | |---------|-------|----------| | [CTA Button] | Hover | [Background darken 10%] | | [CTA Button] | Loading | [Spinner, disabled] | | [Form] | Error | [Red border, error message below] | ### Responsive Behavior | Breakpoint | Changes | |------------|---------| | Desktop (>1024px) | [Default layout] | | Tablet (768-1024px) | [What changes] | | Mobile (<768px) | [What changes] | ### Edge Cases - **Empty state**: [What to show when no data] - **Long text**: [Truncation rules] - **Loading**: [Skeleton or spinner] - **Error**: [Error state appearance] ### Animation / Motion | Element | Trigger | Animation | Duration | Easing | |---------|---------|-----------|----------|--------| | [Element] | [Trigger] | [Description] | [ms] | [easing] | ### Accessibility Notes - [Focus order] - [ARIA labels needed] - [Keyboard interactions] ``` ## If Connectors Available If **~~design tool** is connected: - Pull exact measurements, tokens, and component specs from Figma - Export assets and generate a complete spec sheet If **~~project tracker** is connected: - Link the handoff to the implementation ticket - Create sub-tasks for each section of the spec ## Tips 1. **Share the Figma link** — I can pull exact measurements, tokens, and component info. 2. **Mention edge cases** — "What happens with 100 items?" helps me spec boundary conditions. 3. **Specify the tech stack** — "We use React + Tailwind" helps me give relevant implementation notes.
Источник: anthropics/knowledge-work-plugins / design / design-handoff ↗. Ссылка проверена 2026-10-10.