use-canvas
Create or edit a Design Studio canvas containing views, diagrams, documents, notes, and arrows. Use only when Canvas is enabled.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 161
- Forks
- 25
01 前言 Front Matter
- name
- use-canvas
- description
- Create or edit a Design Studio canvas containing views, diagrams, documents, notes, and arrows. Use only when Canvas is enabled.
03 SKILL.md 正文
Use Canvas
This skill applies when Canvases is enabled. The module README describes rendering and storage.
- Keep embedded artifacts within the canvas's own prototype. Copy another prototype's artifact before embedding it.
- Do not store images in a canvas. Embed the working view instead.
- Prefer native Excalidraw tools for canvas composition: text for annotations, with shapes, lines, arrows, and frames as needed. Sticky notes (the
notekind, Excalidraw'sstickynote) are optional, not the default for screen annotations. - To draw a flowchart, sequence, class, state or ER diagram as shapes the person can rearrange, use the
mermaidtool. For a diagram that stays Mermaid, make a diagram artifact and embed it instead. - Inspect the current scene before changing it. Inspect the result afterward.
- Preserve the person's arrangements. Move existing content only when the request requires it.
- Keep changes small enough to review and undo. Live tool operations support undo. External file edits may not be separate undo steps.
Discover and use tools
Read current tool help instead of assuming argument names or defaults:
pnpm canvas help
pnpm canvas help create
For file operations, run pnpm canvas <file.excalidraw> <tool> '<json>'.
For an open local canvas, compatible browser tools can use window.__studioCanvas. Read its help() before use.
Use describe before and after changes. For live tools, use context when the request refers to the current selection or viewport.
Prefer tools over manual JSON edits. They maintain element bindings and versions. Use point to identify an artifact when live access supports it.
Canvas tools edit existing scenes. Create a canvas through the file menu, or use the empty-scene template from this module's file-type declaration for direct authoring.
For new directly authored artifacts, preview and apply identity assignment. Preserve existing identity metadata when editing.
Verify
Inspect the updated scene with describe, then inspect the rendered canvas and embedded artifacts. Preserve bindings and existing arrangements. Follow the platform working context for required checks and report the canvas link.
04 同仓库更多 Skills
setup-contributor
Register someone joining an existing studio and verify local access. Use configure-studio for a new studio.
manage-modules
Create, install, enable, disable, or remove modules; create, rename, archive, restore, or delete systems through the Studio CLI.
maintain-documentation
Author or audit READMEs, context, and task skills for the platform, modules, and systems; coordinate human Manual updates.
configure-studio
Configure a running studio for the first time, update requested studio settings, or update the studio to a newer Design Studio release. Use setup-contributor for someone joining; installation has its own workflow.
check-design-system
Audit a Design Studio surface against its applicable design system and report findings for human review before any fixes. Use for an explicit design-system review of Studio UI, prototypes, or system previews.
use-__ID__
Use __LABEL__ in Design Studio when the capability is enabled.