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

excalidraw-use — скилл для Claude Code: картинки на доску Excalidraw

Скилл excalidraw-use раскладывает готовые картинки по сцене Excalidraw ровной сеткой, снимает слайды Vite-деки в отдельные изображения и читает .excalidraw на битые картинки.

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

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

Что делает excalidraw-use

Скилл берёт уже существующие картинки (скриншоты, схемы, экспорты) и собирает из них отдельную сцену .excalidraw сеткой. scripts/build_scene.py принимает список файлов, число колонок и шаблон сцены. В конце печатается строка verified: с числом элементов и сверкой хешей. Нет строки — файл отдавать не стоит.

Второй сценарий — слайды. scripts/shoot_deck.mjs читает src/slides/index.ts у Vite/React-деки, снимает каждый слайд и проверяет, что фрагменты раскрылись. --advance задаёт способ перелистывания: pdf, если дека понимает ?pdf=1, иначе keys. Смешивать нельзя: при ?pdf=1 лишние нажатия уводят на следующий слайд. puppeteer должен резолвиться из каталога запуска, иначе скрипт не стартует вообще.

Третий режим — scripts/inspect_scene.py. Считает элементы по типам, размер вложенных данных и сверяет, что у каждой картинки payload совпадает с ключом. В живую доску скилл писать не велит: сцена, открытая в браузере, не перечитывает файл с диска, а следующее сохранение затрёт запись. Отдавайте отдельный файл и вставляйте через буфер обмена; сцена больше ~15 МБ режется scripts/split_scene.py.

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

  • разложить десятки скриншотов по доске ровной сеткой
  • снять каждый слайд Vite-деки в отдельный файл
  • проверить .excalidraw на картинки с несовпадающим payload
  • убрать дубли, сверив изображения по содержимому
  • порезать тяжёлую сцену перед вставкой через буфер

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

  • Разложи эти скриншоты по доске Excalidraw сеткой в 6 колонок и сохрани в tray.excalidraw.
  • Сними все слайды деки в папку shots/ и скажи, если какой-то фрагмент так и не раскрылся.
  • Проверь board.excalidraw: что внутри и не побились ли картинки.

Как установить excalidraw-use

1Через Skills CLI (Vercel)

npx skills add daymade/claude-code-skills --skill excalidraw-use -a claude-code

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

~/.claude/skills/excalidraw-use/SKILL.md

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

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

Вопросы об excalidraw-use

Как установить excalidraw-use в Claude Code?

Команда npx skills add daymade/claude-code-skills --skill excalidraw-use -a claude-code. Файл скилла окажется в ~/.claude/skills/excalidraw-use/SKILL.md.

Что делает excalidraw-use?

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

Почему слайды не снимаются?

shoot_deck.mjs нужен puppeteer, который резолвится из каталога запуска. npx puppeteer не ставит модуль, который найдёт ESM-импорт.

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

SKILL.md · MIT
---
name: excalidraw-use
description: >-
  Places existing images onto an Excalidraw whiteboard, turns a slide deck into clean per-slide
  images, and inspects a .excalidraw file. Use whenever someone mentions Excalidraw, a
  whiteboard/canvas, .excalidraw, 白板 or 画板 — e.g. "put these screenshots on my board" — or a
  workshop delivered by hand-drawing over screenshots on a shared canvas. Not for generating a
  diagram from a text description.
---

# Excalidraw: images onto a board

Excalidraw is a whiteboard people draw on live. This skill covers the part that
is fiddly to do by hand: getting **a lot of existing images** onto a board,
laid out so nobody has to drag them apart afterwards.

It does **not** generate diagrams from prose. If the request is "draw the
architecture" or "make a flowchart", that is a diagram-generation job — several
tools and skills do it, including a `diagram` skill in the gstack suite if the
user has it installed.

## Which job is this?

| The user says | Go to |
|---|---|
| "put these images on my board", "add the old screenshots to the canvas" | **Job 1 — build a pick tray** |
| "turn the deck into images", "screenshot every slide" | **Job 2 — deck to images**, then Job 1 |
| "what's in this file", "how big is this board", "is anything broken" | **Job 3 — inspect** |
| "draw me a flowchart from this description" | not this skill |

## Job 1 — build a pick tray of images

```bash
python3 scripts/build_scene.py \
  --out tray.excalidraw \
  --cols 6 \
  --template-from ~/path/to/their-board.excalidraw \
  --exclude already-placed.png \
  images/*.png
```

Expected output — if you do not see the `verified:` line, the file is not usable:

```
verified: 30 image element(s), hashes match, no overlap
placed 30 image(s), 6 x 5 grid, min gap 600
wrote tray.excalidraw (3.5 MB)
```

**Hand the user the file plus how to get it onto their board.** That second half
is where this goes wrong: at excalidraw.com, both *Open* and drag-and-drop
**replace the entire current scene**. Telling someone to "open this file" when
they have a live board is telling them to lose it. The additive route is the
clipboard — full instructions and the reasoning in
[references/paste_workflow.md](references/paste_workflow.md). Read it before you
write the hand-off message.

Three decisions worth making deliberately:

- **`--template-from` whenever they have an existing board.** Excalidraw's
  published JSON schema documents the top-level shape and the `files` map, but
  not the image element's own fields (`fileId`, `status`, `scale`, `crop`), so
  copying a live element from *their* board is the only way to be sure the field
  set matches the build they actually run. Without it a reasonable default is
  used, which has worked but is one observed field set, not a spec.
  [references/scene_file_format.md](references/scene_file_format.md) has the
  field-by-field breakdown, keeping what the official docs state separate from
  what was read off a real file — open it when you need to hand-build or repair
  a scene rather than let the script write one.
- **`--exclude` anything already on their board.** The check is by image content,
  not filename, so a renamed copy is still caught. Skipping this is how someone
  ends up with the same picture twice and has to delete one by hand.
- **Spacing.** `--cell` is the longest side each image is scaled to; `--pitch` is
  the distance between cell centres. The gap is `pitch - cell`, and the defaults
  (800 / 1400 → 600) are deliberately generous. If a user has ever said "don't
  make me fix the spacing again", raise `--pitch`, don't lower it.

If the scene is more than ~15 MB, split it — the clipboard is where a large
scene stalls:

```bash
python3 scripts/split_scene.py --scene tray.excalidraw --out-dir parts/ --chunks 4
```

## Job 2 — turn a slide deck into clean images

For Vite/React decks whose slides are registered in a `src/slides/index.ts` with
entries shaped `{ id: 'intro', component: S01, fragmentCount: 3 }`.

```bash
# 1. Build the deck FROM SOURCE and serve that build (not a dev server).
cd <deck>; npx vite build --outDir /tmp/deck-dist --emptyOutDir
cd /tmp/deck-dist && python3 -m http.server 8080 &

# 2. Shoot it.
node scripts/shoot_deck.mjs \
  --index <deck>/src/slides/index.ts \
  --url http://127.0.0.1:8080/index.html \
  --out shots/ \
  --advance pdf     # or: keys
```

Expected output:

```
30 slides (7 with fragments), advance=pdf
30/30 captured, 32 inline chrome element(s) hidden -> shots/
all .fragment elements rendered visible (opacity check)
```

That last line is the one that matters. If instead you see
`WARNING: N slide(s) have fragments that never revealed`, those screenshots are
missing content — **do not** feed them into Job 1. Read
[references/deck_screenshot_pitfalls.md](references/deck_screenshot_pitfalls.md);
the usual cause is that the build being served is older than the source.

**`puppeteer` must be resolvable from wherever you run the script.** Decks that
generate their own PDFs usually already have it — run the script from that
project, or symlink its `node_modules` next to the script. `npx puppeteer` does
not install a resolvable module for an ESM import.

**Picking `--advance`:** grep the deck's `Deck` component for `pdf`. If it reads
a `?pdf=1` query, use `pdf`; otherwise `keys`. Never both — under `?pdf=1` the
fragment index is already at maximum, so extra key presses move to the *next*
slide and you silently capture the wrong content.

Add `--strict` to make unrevealed fragments a non-zero exit when this runs
inside a pipeline. It stays a warning by default so a deck that legitimately
keeps a `.fragment` hidden does not fail the whole run.

## Job 3 — inspect a scene

```bash
python3 scripts/inspect_scene.py board.excalidraw --images
```

Reports element counts by type, embedded payload size, whether every image
element resolves to a file whose content still matches its key, and the occupied
extent. Read-only.

The **extent** is the practically useful number: pasted content lands wherever
the viewport is, so knowing where existing work sits is how you tell the user
where to scroll before pasting.

## Never write into their live board file

Build a separate scene file and let the user paste from it. Two independent
reasons, both observed:

- A board that is open in a browser tab does not reload when the file on disk
  changes, and the next in-app save overwrites whatever you wrote.
- The file on disk is usually **older than the browser's state** — someone
  exported it days ago and has been working in the tab since. Merging into that
  export silently drops everything they have done since.

If a merged file is genuinely wanted, write it to a **new path** and let the user
choose which to open. Never overwrite the original.

## Troubleshooting

| Symptom | Cause | Fix |
|---|---|---|
| Scene opens but a picture is blank | `files` entry missing or its key does not match the payload | `inspect_scene.py` reports both; rebuild |
| Images touch or overlap on the board | `--pitch` not greater than `--cell` | the script refuses this combination; raise `--pitch` |
| Paste does nothing / takes forever | scene too large for the clipboard | `split_scene.py`, then paste each part |
| Pasting replaced the whole board | *Open* / drag-and-drop was used instead of copy-paste | see references/paste_workflow.md; recover with in-app undo |
| Slides captured missing their later content | fragments never revealed | rebuild the deck from source, re-serve, re-shoot |
| Key-press badges appear in slide screenshots | the wait for them to fade was cut short | the script already waits ~2.9 s after the last press; if a deck lingers longer, raise it |
| `Cannot find package 'puppeteer'` | not resolvable from the script's location | run from a project that has it |
| Image drawn at the wrong shape | element aspect ratio does not match the source | `build_scene.py` fails on this rather than writing it |

## Next step

After a tray is built, the natural follow-up is the paste itself, which only the
user can do. Give them the file path, the scroll-to-empty-space warning, and the
three-key sequence — then stop. Do not open excalidraw.com to "verify" the file:
loading a scene there replaces whatever is in that browser's current session,
which may be the board you were trying to protect.

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

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

Все скиллы по теме «Дизайн» →
Excalidraw docker MCP-сервер Excalidraw рисует диаграммы и схемы от руки прямо в чате с агентом. Показывает анимацию отрисовки линий и блоков. CX Codex +1 excalidraw-skill lingzhi227 Скилл даёт агенту инструменты для рисования и правки диаграмм Excalidraw на живом канвасе, с экспортом в файлы и картинки. CX Codex +1 1 600установок excalidraw-mcp-server reason-machines Учит агента собирать MCP-серверы, которые отдают интерактивные диаграммы Excalidraw в стиле от руки, с потоковой дорисовкой и управлением областью просмотра. CX Codex +1 235установок diagram-maker openclaw Скилл diagram-maker для Claude Code, Codex, Cursor и других платформ, который создаёт диаграммы в SVG/HTML или Excalidraw. Срабатывает, когда нужно визуализировать архитектуру, процесс или концепцию. CX Codex +1 524установок excalidraw-diagram-generator официальный github Скилл excalidraw-diagram-generator для GitHub Copilot превращает описание на обычном языке в диаграмму Excalidraw. Показывает процессы, связи между объектами и устройство системы. CX Codex +1 31 639установок excalidraw-diagram coleam00 Скилл excalidraw-diagram для Claude Code: генерирует .excalidraw JSON-файлы схем архитектуры и процессов. Наглядно разбирает структуру системы или алгоритм без ручного рисования. CX Codex +1 8 900установок

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

Весь набор →
continue-claude-code-work Скилл continue-claude-code-work возвращает прерванную работу Claude Code по истории сессии: восстанавливает цель, незавершённые запросы и следующий шаг. CX Codex +1 216установок interaction-design-board Скилл interaction-design-board собирает несколько кликабельных HTML-прототипов одного интерфейса в Design Board, где можно выбрать вариант или попросить ремикс до того, как агент изменит продакшен-код. CX Codex +1 213установок 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установок meme-creator Скилл meme-creator для Claude Code накладывает логотипы, аватары и стикеры на движущиеся объекты в видео и сохраняет результат в MP4 и GIF. Создаёт мемы и реакции из видеоклипов. CX Codex +1 174установок agent-web-search-setup Скилл agent-web-search-setup для Claude Code и других платформ диагностирует и чинит веб-поиск на моделях через прокси и реселлеров. CX Codex +1 162установок macos-permissions Скилл macos-permissions для Claude Code находит причины сбоев TCC, сетевых алертов и зависших окон Keychain. Помогает при бесконечных диалогах и падении фоновых LaunchAgent. CX Codex +1 152установок tech-selection Скилл tech-selection для Claude Code помогает выбрать или пересмотреть библиотеку, фреймворк, хранилище или архитектуру. Запускается перед тем, как зафиксировать техническое решение. CX Codex +1 151установок

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

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