sb-whiteboard

Stable Baseline: whiteboards

What this skill does

Builds freeform Excalidraw boards: shapes, sticky notes, connectors, frames, stencils, architecture icons, embedded source-backed diagrams and images. Every change runs under the signed in user's own Stable Baseline identity.

IDs are never hardcoded. Resolve projectId and documentId at runtime from listing calls. A whiteboard is a kind of document, so its identifier is a documentId.

Read this first

Call getWhiteboardGuide before your first board in a session. It returns the current guidance on element choice, layout, verification, and how to edit a large board safely by patching elements by id rather than replacing the scene. Guessing produces poor boards.

The server's own priority order for element choice: stencil, then architecture icon, then a code or BPMN diagram, then plain shapes, then an image. Reach for the richest representation that fits, not plain rectangles.

Sticky notes are a first-class type, not a stencil. Use addWhiteboardElements with {type: 'sticky', text, backgroundColor}. There is no sticky note stencil.

Before you build

1. Resolve scope. listOrganisations, listWorkspaces, listProjects. Ask if several projects are accessible.
2. Check what exists. listWhiteboards requires projectId. Do not duplicate a board that is already there.
3. Read an existing board before editing it. getWhiteboard, and getWhiteboardImage when you need to see what it looks like.

Placement: the failure that ruins boards

Never guess x and y on a board that already has content. Guessed coordinates land on top of existing shapes and produce an unreadable pile. Two safe options:

• Omit x and y entirely. The server auto-places the new elements together in clear space below the current content. This is the right default.
• Call getWhiteboard with includeElements: true first, see where things already are, and choose a genuinely empty region.