atmos-canvas-agentlisted
Install: claude install-skill AruNi-01/atmos
# Atmos Canvas Agent Skill
This skill teaches agents that can run the `atmos` CLI **how** to drive the Atmos Canvas with layouts that stay stable (page-bounds math + tldraw native align/stack).
---
## Prerequisites the agent must check
Always probe in this order (cheaper checks first):
1. **`atmos` CLI** is on `PATH` (`atmos --version`).
2. **A live Canvas tab is registered** — run `atmos canvas status`.
3. **Bridge is enabled** — Canvas Bot popover → **Enable bridge** ON. Mutating commands fail with `BRIDGE_DISABLED` until this is on.
---
## Diagram workflow (read this before drawing)
For multi-shape diagrams (feature grids, architecture maps, slide-like layouts):
1. **`get-state`** — note `viewport`, shape ids/types/bounds (no terminal pane text).
2. **Plan regions** — title band, card grid, footer. Prefer explicit `--x --y` or `place` over blind stacking.
3. **Containers first** — `create-frame` for sections; fixed-size cards use **`create-geo`** (`rectangle`) with `--w --h --text`, not `create-note`.
4. **Create content** — always pass coordinates, or omit **both** `x` and `y` to get staggered auto-placement (never one without the other).
5. **Layout with native tools** (preferred over hand-tuned coordinates):
- `align` — line up edges/centers (`top`, `bottom`, `left`, `right`, `center-horizontal`, `center-vertical`).
- `stack` — horizontal/vertical row with gap.
- `distribute` — even spacing (needs ≥3 shapes).
- `layout-grid` / `layout-row` / `layout