excalidraw-use

1# Excalidraw: images onto a board
2 
3Excalidraw is a whiteboard people draw on live. This skill covers the part that
4is fiddly to do by hand: getting **a lot of existing images** onto a board,
5laid out so nobody has to drag them apart afterwards.
6 
7It does **not** generate diagrams from prose. If the request is "draw the
8architecture" or "make a flowchart", that is a diagram-generation job — several
9tools and skills do it, including a `diagram` skill in the gstack suite if the
10user has it installed.
11 
12## Which job is this?
13 
14| The user says | Go to |
15|---|---|
16| "put these images on my board", "add the old screenshots to the canvas" | **Job 1 — build a pick tray** |
17| "turn the deck into images", "screenshot every slide" | **Job 2 — deck to images**, then Job 1 |
18| "what's in this file", "how big is this board", "is anything broken" | **Job 3 — inspect** |
19| "draw me a flowchart from this description" | not this skill |
20 
21## Job 1 — build a pick tray of images
22 
23```bash
24python3 scripts/build_scene.py \
25  --out tray.excalidraw \
26  --cols 6 \
27  --template-from ~/path/to/their-board.excalidraw \
28  --exclude already-placed.png \
29  images/*.png
30```
31 
32Expected output — if you do not see the `verified:` line, the file is not usable:
33 
34```
35verified: 30 image element(s), hashes match, no overlap
36placed 30 image(s), 6 x 5 grid, min gap 600
37wrote tray.excalidraw (3.5 MB)
38```
39 
40**Hand the user the file plus how to get it onto their board.** That second half
41…