lark-whiteboard

Query, export, and edit Lark whiteboards using lark-cli and whiteboard-cli.

2|Updated Aug 9, 2026
One-click install
npx skills add https://github.com/DeepJH/doubao-skill-and-info --skill lark-whiteboard-deepjh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-whiteboard
Source: https://github.com/DeepJH/doubao-skill-and-info/tree/main/skills/lark-whiteboard
Command: npx skills add https://github.com/DeepJH/doubao-skill-and-info --skill lark-whiteboard-deepjh

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It lets you view, export, and edit whiteboards inside Lark (Feishu) cloud documents without manually opening the document UI, supporting preview images, SVG export, source code extraction, and structured content updates. ## Core Features & Use Cases - Whiteboard Export: Export a board as a preview image, SVG vector graphic, Mermaid/PlantUML source code, or raw OpenAPI node structure. - Whiteboard Update: Write content back to a board using Mermaid, PlantUML, SVG, or raw OpenAPI node formats, with idempotent tokens for safe retries. - Diagram Authoring Workflows: Create architecture diagrams, flowcharts, fishbone diagrams, funnels, flywheels, bar/line charts, comparison tables, and more via DSL, SVG, or Mermaid routes with scene-specific layout guides. - Use Case: Given a document URL containing a whiteboard, export it as a PNG preview to review the content, then regenerate an updated architecture diagram and write it back to the same board. ## Quick Start Use the lark-whiteboard skill to export the whiteboard in this Lark document as a preview image and show me its contents.

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, --output-type preview, and an --output path. The CLI saves the result as a PNG or JPG depending on the actual image type returned.

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

Pipe your diagram code into lark-cli whiteboard +update with --input_format mermaid or plantuml and --source -. Add --overwrite to replace existing content and an --idempotent-token for safe retries.

What tools are required to use the Lark whiteboard skill?

You need lark-cli installed and the @larksuite/whiteboard-cli npm package (version ^0.2.13), which is invoked via npx. Both are verified at startup with version checks before any board operation.

Can I extract Mermaid or PlantUML code from an existing whiteboard?

Yes, use +export --output-type source. It only works when the board contains exactly one PlantUML or Mermaid diagram; otherwise the response reports that no source or multiple nodes exist.

Why does writing images to a Lark whiteboard fail with error 2891001?

The image token belongs to a different resource domain, such as docx_image or Drive. Download the image and re-upload it with docs +media-upload --parent-type whiteboard --parent-node <board token> to get a whiteboard-domain media token.

When should I use the DSL route instead of Mermaid for whiteboard diagrams?

Use the DSL route for complex diagrams like architecture, fishbone, funnel, flywheel, or bar charts that need precise layout control. Mermaid is reserved for mind maps, sequence diagrams, class diagrams, pie charts, and Gantt charts.