lark-whiteboard

Query, export, and edit Lark whiteboards using Mermaid, PlantUML, SVG, or DSL formats.

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

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 lets you export whiteboard content as preview images, SVG, or source code, and create or update boards using Mermaid, PlantUML, SVG, or a structured DSL. ## Core Features & Use Cases - Export Whiteboards: Export boards as preview images, SVG vector graphics, Mermaid/PlantUML source code, or raw OpenAPI node JSON. - Create and Update Diagrams: Write content via +update using Mermaid, PlantUML, SVG, or DSL-generated OpenAPI JSON, with overwrite or incremental append modes. - Rich Diagram Scenes: Built-in guides and script templates for architecture diagrams, flowcharts, fishbone diagrams, funnels, flywheels, bar charts, comparison matrices, and more. - Use Case: Ask the assistant to draw a microservices architecture diagram into an existing Feishu whiteboard; it generates DSL JSON, renders a PNG preview for review, converts to OpenAPI format, and writes it to the board. ## Quick Start Ask the assistant to export the whiteboard with token wbcnXXX as a preview image, or to draw a flowchart into that whiteboard using the lark-whiteboard skill.

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 the whiteboard token and --output-type preview, specifying an output 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 or pass a file to lark-cli whiteboard +update with --input_format mermaid or plantuml. Use --overwrite to replace all existing content, or omit it to append incrementally.

What diagram types can I create in a Lark whiteboard?

Supported scenes include architecture diagrams, flowcharts, organization charts, swimlanes, comparison tables, fishbone diagrams, bar and line charts, treemaps, funnels, pyramids, flywheels, and milestones. Mind maps, sequence diagrams, class diagrams, and pie charts use the Mermaid path instead.

Why does my whiteboard update fail when using images?

Image nodes require a whiteboard-domain media token. Upload each image with lark-cli docs +media-upload --parent-type whiteboard --parent-node <board_token> first; using docx or Drive tokens causes API error 2891001.

Can I edit an existing whiteboard without losing its content?

Yes. If the board was drawn from a single Mermaid or PlantUML source, edit the source and overwrite. For additions only, use append mode without --overwrite. Structural changes go through the SVG edit route, which is lossy and requires user confirmation.

What tools are required to use this whiteboard skill?

You need lark-cli for whiteboard API operations and the @larksuite/whiteboard-cli npm package (version ^0.2.13) for rendering DSL JSON to PNG and converting it to OpenAPI format.