lark-whiteboard

Query and edit Lark whiteboards using PlantUML, Mermaid, or OpenAPI node formats.

1.3k|142|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/MiniMax-AI/minimax-code --skill lark-whiteboard-minimax-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-whiteboard
Source: https://github.com/MiniMax-AI/minimax-code/tree/main/packages/local-runtime/assets/skills/lark-tools/cli-skills/lark-whiteboard
Command: npx skills add https://github.com/MiniMax-AI/minimax-code --skill lark-whiteboard-minimax-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Reading and editing whiteboards embedded in Lark (Feishu) cloud documents requires manual UI work; this Skill lets you programmatically export whiteboard previews, extract diagram code, and update whiteboard content from the terminal. ## Core Features & Use Cases - Whiteboard Querying: Export a whiteboard as a preview image, extract its PlantUML/Mermaid source code, or dump the raw OpenAPI node structure. - Whiteboard Updating: Create or overwrite whiteboard content using PlantUML, Mermaid, or the native OpenAPI node format, including content generated by the whiteboard-cli DSL. - Use Case: After creating blank whiteboards in a Lark document, retrieve their board tokens and fill each one with an architecture diagram, flowchart, or timeline generated from Mermaid code or the whiteboard-cli DSL. ## Quick Start Use the lark-whiteboard skill to export the whiteboard with token wbcnxxxxxxxx as a preview image saved to preview.png.

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 +query with the --whiteboard-token, --output_as image, and --output path parameters. The command saves a preview image of the whiteboard to the specified file, and you can add --overwrite to replace an existing file.

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

Use lark-cli whiteboard +update with --input_format set to mermaid or plantuml and pass the code via --source, either from a file with @path or from stdin with -. Add --overwrite to replace all existing whiteboard content.

Where do I find the whiteboard token in a Lark document?

Fetch the document with the lark-doc +fetch command and parse the <whiteboard token="xxx"/> tag from the returned markdown. When creating new whiteboards via docs +update, the tokens are returned in the data.board_tokens field.

Why can't I export PlantUML or Mermaid code from my whiteboard?

Code export with --output_as code only works when the whiteboard contains exactly one PlantUML or Mermaid diagram. If there are zero or multiple nodes, the response reports that code export is unavailable; use --output_as image or raw instead.

When should I use the raw OpenAPI format versus whiteboard-cli?

The raw OpenAPI node format suits only simple edits like changing text or colors, since hand-writing the JSON is discouraged. For complex diagrams such as architecture, swimlane, or funnel charts, generate content with the whiteboard-cli DSL and pipe it into +update.