whiteboard-gui

Applies notes, questions, and decisions to a Curatorial Whiteboard canvas via semantic transactions.

108|11|Updated Jun 26, 2026
One-click install
npx skills add https://github.com/db-aeon/joshu-oss --skill whiteboard-gui-db-aeon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whiteboard-gui
Source: https://github.com/db-aeon/joshu-oss/tree/main/arozos/subservice/excalidraw/skills/whiteboard-gui
Command: npx skills add https://github.com/db-aeon/joshu-oss --skill whiteboard-gui-db-aeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It keeps a shared Excalidraw whiteboard synchronized with the conversation by turning discussion points into classified sticky notes, open questions, and decisions directly on the canvas instead of leaving them as chat-only text. ## Core Features & Use Cases - Semantic board transactions: Creates and updates stickies through proposeTransaction with note, open_question, and decision kinds, each carrying provenance linking back to conversation or sources. - Grounded reference resolution: Resolves demonstratives like "these" or "this" from the current canvas selection or pointer context, calling showFocus before consequential changes. - Bounded recall: Pulls relevant facts onto the board with recallToBoard when information is missing from the visible canvas. - Use Case: During a project review, ask the agent to capture open questions and confirmed decisions; it places stickies on the board in the same turn and stamps small action notes under existing cards. ## Quick Start Ask the agent to review the current whiteboard session and put all open questions and decisions on the board as stickies.

Frequently Asked Questions about whiteboard-gui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add notes to a whiteboard from a chat conversation?

Ask the agent to capture the discussion on the board; it calls proposeTransaction with one UPSERT_OBJECT per sticky, classifying each item as a note, open_question, or decision with conversation provenance. Changes apply immediately without accept chips.

How does the whiteboard agent resolve references like "these" or "this"?

The current canvas selection takes priority over chat history, so demonstratives map to selectedItems. When selection is empty, the pointer context is used, and low-confidence targets trigger a showFocus highlight plus one confirmation question.

Can the agent edit Excalidraw elements or scene JSON directly?

No. The skill forbids sending Excalidraw elements, scene JSON, element IDs, or arbitrary patches. All changes go through semantic CWM actions like proposeTransaction, recallToBoard, and stageOpening.

What happens when existing whiteboard stickies are marked done?

The original sticky text stays unchanged. The agent submits an UPSERT per target, and the UI places a small action note such as an arrow annotation under each card derived from the transaction rationale.

Why did the whiteboard not update after a review request?

Review or orientation turns must call proposeTransaction, recallToBoard, or stageOpening before ending. A chat-only answer is treated as a protocol failure, and the platform retries once before reporting the board was not updated.