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

interaction-design-board — скилл для Claude Code

Скилл interaction-design-board собирает несколько кликабельных HTML-прототипов одного интерфейса в Design Board, где можно выбрать вариант или попросить ремикс до того, как агент изменит продакшен-код.

MIT 213 установок ★ 1 540 обновлён 2026-10-25

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

Что делает interaction-design-board

Скилл фиксирует факты продукта (данные, действия, токены дизайна) и генерирует три или больше автономных HTML-файлов с разной архитектурой взаимодействия: что показано сразу, что скрыто, как пользователь перемещается между состояниями. Каждый прототип работает в браузере, и все они встраиваются в Design Board — страницу, где можно переключаться между вариантами, оставлять замечания и выбирать финальное решение. Скилл запускает build_board.py, который отклоняет одинаковые кандидаты и внешние зависимости, а затем открывает Board через gstack design serve или напрямую в браузере.

Подходит для выбора навигации, раскрытия деталей, порядка действий или иерархии информации. Для статичного подбора стилей есть design-style-picker. Без Python 3 и скрипта build_board.py Board не соберётся.

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

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

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

  • Собери Design Board для страницы заказа: один вариант с формой сверху, другой — с корзиной слева, третий — пошаговый
  • Сгенерируй три прототипа дашборда с разной навигацией и открой Board
  • Построй Board для карточки товара: вариант с табами, вариант с раскрывающимися секциями и вариант одной колонкой

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

1Через Skills CLI (Vercel)

npx skills add daymade/claude-code-skills --skill interaction-design-board -a claude-code

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

~/.claude/skills/interaction-design-board/SKILL.md

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

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

Вопросы об interaction-design-board

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

Выполни npx skills add daymade/claude-code-skills --skill interaction-design-board -a claude-code, затем агент загрузит ~/.claude/skills/interaction-design-board/SKILL.md.

Что делает interaction-design-board?

Скилл генерирует несколько самодостаточных HTML-прототипов одного интерфейса с разной архитектурой взаимодействия, собирает их в Design Board и ждёт выбора или запроса на ремикс до правки продакшен-кода.

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

Python 3 и скрипт build_board.py из репозитория скилла. Без них Board не соберётся. Для запуска сервера нужен gstack design, но Board работает и при прямом открытии HTML-файла.

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

SKILL.md · MIT
---
name: interaction-design-board
description: >-
  Generates several distinct, clickable HTML interaction prototypes for one product surface into a
  Design Board and collects selection/remix feedback before implementation. Use for multiple UI
  versions, interaction alternatives, progressive-disclosure options, or when styling is fine but
  hierarchy/workflow/interaction feels off. Not for static visual-style calibration (use
  design-style-picker) or a settled CSS tweak.
---

# Interaction Design Board

Turn interaction uncertainty into inspectable evidence. Keep the product's real
facts and design language fixed; vary the interaction architecture enough that the
user can experience the trade-offs before production code changes.

## Route The Request

- Use this skill when the choice depends on behavior, state, workflow, hierarchy,
  or progressive disclosure.
- Use `design-style-picker` for static visual-style calibration and image matrices.
- Use gstack's `design-consultation` for a new product-wide design system and
  gstack's `design-shotgun` for static generated mockups.
- Return to this skill after a visual direction is chosen if the user still needs
  to compare clickable interaction structures.
- Do not use it for a settled one-line CSS adjustment or when the user already
  supplied an approved interaction specification and asked only for implementation.

## Non-Negotiable Outcome

Produce a decision, not a gallery:

1. Several runnable HTML candidates keep the same business facts, product scope,
   design tokens, and available actions.
2. Each candidate embodies a distinct interaction hypothesis rather than a skin.
3. The Design Board lets the user operate every candidate, record concrete
   feedback, select one, or request a named remix.
4. Production implementation does not start until the user approves the behavior.

Static screenshots are supporting evidence only. A screenshot cannot prove a
collapse state, keyboard path, selection model, or task handoff.

## Workflow

### 1. Freeze The Decision Contract

Before generating variants, write a compact contract in the session workspace:

- **User job:** the real task the operator is trying to complete.
- **Decision scope:** the one page, component, or bounded journey being compared.
- **Immutable facts:** real objects, labels, statuses, permissions, actions, and
  data semantics that every variant must preserve.
- **Existing language:** current tokens, components, navigation, density, and
  brand assets that must remain recognizable.
- **First-view invariant:** what must stay visible before any disclosure.
- **Interaction states:** the meaningful states the user must be able to exercise.
- **Stop condition:** approved variant or explicit remix brief; no product edit yet.

For an existing product, inspect its rendered page and implementation before
writing the contract. Do not replace unknown facts with plausible sample data. Mark
unknowns as unknown or omit them if they are not needed for the interaction choice.

When the decision replaces a screen that already ships, enumerate its current
user-visible behaviors as a numbered inventory during that inspection: every action,
state, deep link, keyboard path, empty state, and copy affordance. Candidates are free
to defer or drop any of them — the inventory exists so that a dropped behavior is a
stated trade-off rather than an unnoticed regression.

Read `references/interaction-design-method.md` before proposing the candidate
architectures. It contains the hierarchy, progressive-disclosure, comparison, and
accessibility rules that decide whether a direction is legitimate.

### 2. Propose Different Interaction Architectures

Propose three candidates by default. Add candidates only when another independent
interaction hypothesis exists; do not inflate the board with minor variants.

For each candidate state:

- the hypothesis about how it helps the user's job;
- what it makes primary;
- what it defers or hides;
- the likely trade-off;
- the states and actions that must work in the prototype.

Hold the decision contract constant. Change navigation/selection/disclosure/action
ownership or information order—not colors, copy, and data all at once. Useful
families include command-first, queue-detail, object-led, comparison-led, and
ledger-first, but derive candidates from the current task rather than filling a
pattern quota.

### 3. Generate Isolated Runnable Candidates

Create one self-contained HTML file per candidate in a session workspace outside
the product source tree. Keep CSS and JavaScript inline; avoid runtime network
dependencies so every prototype survives inside the Board.

When independent worker contexts are available, assign one candidate to each
worker with the same frozen decision contract and only that candidate's hypothesis.
Do not let workers see one another's output. This isolation is the test-time-scaling
mechanism: it preserves distinct hypotheses instead of converging into siblings.
If workers are unavailable, generate serially but re-read the frozen contract—not
the previous candidate—before starting the next one.

Each candidate must implement the declared states. Decorative buttons that do
nothing are not interaction prototypes. Use honest local state; do not simulate a
backend response the product does not have.

### 4. Build And Open The Design Board

Create `board.json` using `references/board-contract.md`, then run:

```bash
SKILL_ROOT="<absolute directory containing this loaded SKILL.md>"
python3 "$SKILL_ROOT/scripts/build_board.py" \
  --manifest <session-dir>/board.json \
  --output <session-dir>/design-board.html
```

Expected output:

```text
BOARD_BUILT variants=<derived count> output=<absolute path>
```

The builder rejects byte-identical candidates, path traversal, missing declared
states, and static external styles, scripts, or media. The Board also injects a
network-denying Content Security Policy into every sandboxed candidate so dynamic
JavaScript cannot create an undeclared runtime dependency. Fix the candidate; do
not weaken either boundary to make the Board green.

If gstack's design executable is already installed, resolve its absolute path from
the active gstack Skill installation; do not assume `$D` exists in a new shell. Then
capture the exact Board URL printed by the server:

```bash
GSTACK_DESIGN="<resolved gstack design executable>"
SERVER_OUTPUT="$("$GSTACK_DESIGN" serve \
  --html <session-dir>/design-board.html --timeout 1800 2>&1)"
printf '%s\n' "$SERVER_OUTPUT"
BOARD_URL="$(printf '%s\n' "$SERVER_OUTPUT" | sed -n 's/^BOARD_URL: //p' | tail -1)"
test -n "$BOARD_URL"
```

If the executable cannot be resolved or the command prints no `BOARD_URL`, open
`design-board.html` directly with the host's browser-opening tool. Direct-file mode
remains functional: Submit and Remix download `feedback.json` or
`feedback-pending.json` for the agent to read. The Board itself is the chooser;
chat is only the fallback channel.

### 5. Observe Tasks, Not Vibes

Ask the user to operate the same representative task in every candidate. Record:

- what they noticed first;
- where they knew or did not know what to do next;
- which disclosure helped or hid necessary evidence;
- which state transition felt natural or surprising;
- which elements to preserve, reject, or remix.

Do not replace these observations with a numeric score or a claim that the most
polished candidate is best. The user may choose one candidate or combine named
parts of several.

When `feedback-pending.json` appears, preserve the accepted parts, alter the named
failure axis, regenerate only the affected candidates, and build a versioned Board
file in the same session directory. If a gstack Board is already serving, reload
that exact Board instead of calling `serve` again on the old source path:

```bash
curl -sS -X POST "${BOARD_URL%/}/api/reload" \
  -H 'Content-Type: application/json' \
  -d '{"html":"<absolute-versioned-board-path>"}'
```

Expected response: `{"reloaded":true}`. Repeated `serve` calls may reuse a Board
instance without reading changed bytes, so they are not a reload mechanism. Ask the
user to retry the task in the same Board URL. Stop adding rounds when feedback no
longer changes the decision.

### 6. Freeze Approval Before Production

After the user confirms your feedback summary, write `approved.json` beside the
Board using the schema in `references/board-contract.md`. Capture:

- selected or remixed candidate;
- approved interaction rules and first-view invariant;
- rejected trade-offs;
- states the user actually exercised;
- remaining unknowns;
- exact prototype file identities.

Then—and only then—implement in the product. Preserve the current design system and
real data contracts. Use the project's frontend implementation and visual-QA skills,
then verify the same representative task in the real browser. Pixel resemblance is
insufficient; the approved state transitions and information order must survive.

If you built a behavior inventory in step 1, the implementation is not delivered until
every line of it carries a disposition: kept, changed to what, or dropped and why. Put
that table where reviewers of the change will read it, not only in the session
workspace. The removals are the load-bearing rows — a behavior nobody can account for
is a regression that was never filed, and the author is the last person able to notice
it. Expect the count of intentional removals to be wrong on the first pass; recheck it
against the inventory before calling the change complete.

If the project has a design SSOT, write the approved interaction decision there as
part of implementation. Keep session feedback and prototype files as evidence; do
not copy their changing values into general project instructions.

## Failure Boundaries

- Do not turn every candidate into a different product or data model.
- Do not let static image generation stand in for runnable interaction.
- Do not hide identity, current status, primary evidence, or the next action behind
  progressive disclosure when they are necessary to decide.
- Do not implement the apparent winner before the user has operated it.
- Do not write prototypes into production component directories.
- Do not claim usability validation from the author's own click-through. Agent QA
  catches broken states; the user's task observation decides the interaction.

## Delivery

Return the Board path or URL, candidate hypotheses, feedback/approval artifact
paths, browser verification performed, and the explicit next step: iterate the
Board, implement the approved candidate, or stop.

© daymade · MIT · daymade/claude-code-skills

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

Все скиллы по теме «Дизайн» →
create-design-md syahiidkamil Команда create-design-md создаёт файл DESIGN.md с визуальной айдентикой проекта: собирает требования, рисует три HTML-варианта дизайна для сравнения в браузере, фиксирует выбранное направление в формате Stitch. CX Codex +1 ★ 406звёзд репо html-to-interaction-prompts MengTo Скилл html-to-interaction-prompts превращает готовую HTML-страницу в статью с промптами для ИИ-конструктора: разбирает анимации, снимает скриншоты, пишет описания. CX Codex +1 1 800установок kanban-board nexu-io Скилл kanban-board для Claude Code собирает одностраничную канбан-доску с колонками, карточками, фильтрами и сводкой спринта. Создаёт макеты task board и sprint board. CX Codex +1 240установок loft Yeachan-Heo Скилл loft разрешает спорные вопросы архитектуры и дизайна с помощью одноразового прототипа, который не попадает в main. CX Codex +1 189установок web-design-engineer ConardLi Скилл web-design-engineer для Claude Code и других агентов: настраивает вёрстку веб-интерфейсов на HTML, CSS, JavaScript и React — дашбордов, прототипов и анимаций. CX Codex +1 10 200установок interaction-design aj-geddes Скилл interaction-design для Claude Code, Cursor и Codex помогает проектировать интерфейсы с анимациями, микровзаимодействиями и обратной связью. Запускается при работе над сценариями, переходами и загрузкой. CX Codex +1 511установок

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

Весь набор →
read-claude-code-history Скилл read-claude-code-history для Claude Code ищет и экспортирует историю локальных сессий. Он помогает найти исходные сообщения, контекст разговора и сведения о командах и вызовах инструментов. CX Codex +1 223установок read-codex-history Скилл read-codex-history для Codex, Claude Code, Cursor, GitHub Copilot и Gemini CLI, который читает, ищет и экспортирует локальную историю сессий OpenAI Codex без возобновления работы. CX Codex +1 221установок prior-work-retrieval Скилл prior-work-retrieval для Claude Code находит и проверяет уже существующие наработки в проекте до написания нового кода. Запускается по прямому запросу о повторном использовании. CX Codex +1 218установок continue-claude-code-work Скилл continue-claude-code-work возвращает прерванную работу Claude Code по истории сессии: восстанавливает цель, незавершённые запросы и следующий шаг. CX Codex +1 216установок codex-1m-context-window-setup Скилл codex-1m-context-window-setup для Codex настраивает и проверяет окно контекста, включая автоуплотнение и расширение до 500K или 1M. Помогает диагностировать лимиты модели. CX Codex +1 211установок lark-cli-router Скилл lark-cli-router маршрутизирует задачи для Feishu, Lark и Doubao через встроенные руководства утилиты lark-cli. Помогает безопасно вызывать API документов, встреч, задач и чатов. CX Codex +1 210установок excalidraw-use Скилл excalidraw-use раскладывает готовые картинки по сцене Excalidraw ровной сеткой, снимает слайды Vite-деки в отдельные изображения и читает .excalidraw на битые картинки. CX Codex +1 187установок meme-creator Скилл meme-creator для Claude Code накладывает логотипы, аватары и стикеры на движущиеся объекты в видео и сохраняет результат в MP4 и GIF. Создаёт мемы и реакции из видеоклипов. CX Codex +1 174установок

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

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