lark-whiteboard

Query, export, and edit Lark whiteboards using CLI commands and diagram DSL.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/dulltackle/kangkang-skills --skill lark-whiteboard-dulltackle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-whiteboard
Source: https://github.com/dulltackle/kangkang-skills/tree/main/lark-whiteboard
Command: npx skills add https://github.com/dulltackle/kangkang-skills --skill lark-whiteboard-dulltackle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @larksuite/whiteboard-cli, and includes references (resource) components.

What problem does it solve? Viewing and editing Lark (Feishu) whiteboards programmatically is difficult because the native OpenAPI node format is verbose and hard to author by hand. This Skill provides structured workflows to export whiteboard content and create or update diagrams using Mermaid, PlantUML, SVG, or a dedicated whiteboard DSL. ## Core Features & Use Cases - Export Whiteboards: Export boards as preview images, SVG vector graphics, Mermaid/PlantUML source code, or raw OpenAPI node structures via lark-cli whiteboard +export. - Create and Update Diagrams: Write content back to boards with +update supporting mermaid, plantuml, svg, and raw formats, with overwrite or incremental append modes. - Rich Diagram Authoring: Built-in scene guides and layout rules for architecture diagrams, flowcharts, fishbone diagrams, funnels, flywheels, bar charts, comparison matrices, and more, rendered through the whiteboard-cli toolchain. - Use Case: A user asks to draw a microservices architecture diagram in a Feishu doc's whiteboard. The Skill fetches the board token, generates DSL JSON following the architecture scene guide, renders a PNG preview for verification, converts to OpenAPI format, and writes it to the board. ## Quick Start Use the lark-whiteboard skill to export the whiteboard at this document URL as a preview image, then create a layered architecture diagram and write it back to the board.

Frequently Asked Questions about lark-whiteboard

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

FAQPage Schema
How do I export a Lark whiteboard as an image?

Run lark-cli whiteboard +export with --whiteboard-token and --output-type preview, plus --output for the save path. The file extension is determined by the returned Content-Type, such as .jpg for image/jpeg.

How do I update a Feishu whiteboard with Mermaid or PlantUML code?

Pipe the source code into lark-cli whiteboard +update with --input_format mermaid or plantuml and --source -. Add --overwrite to replace existing content, or omit it to append incrementally while preserving original nodes.

What diagram types can the whiteboard DSL create?

The DSL supports architecture diagrams, flowcharts with Dagre auto-layout, organization charts, swimlanes, comparison matrices, fishbone diagrams, bar and line charts, treemaps, funnels, pyramids, flywheels, and milestone timelines. Mind maps, sequence diagrams, and pie charts use Mermaid instead.

Why does my whiteboard update fail when inserting images?

Images must be uploaded to the target board first using docs +media-upload with --parent-type whiteboard to get a whiteboard-domain media token. Using tokens from other domains like docx_image causes API error 2891001 or missing images.

Can I edit an existing whiteboard without losing content?

Yes, use incremental append mode by omitting --overwrite so new elements are added while original nodes stay untouched. For structural changes, export the source or SVG first, since overwrite mode rebuilds the entire board and is lossy.

What is the difference between Mermaid and DSL paths for whiteboard diagrams?

Mermaid suits mind maps, sequence diagrams, class diagrams, and pie charts. The DSL path handles complex layouts like architecture, flowcharts, and fishbone diagrams, offering precise control over flex layout, Dagre topology, colors, and connectors.