lark-whiteboard Skill for Claude: Export and Edit Lark Whiteboards

Lets Claude export Lark or Feishu whiteboards as images or code, and draw or update diagrams on them from Mermaid, PlantUML or SVG.

Installs: 475.7K; on skills.sh
Stars: 17.9K; on GitHub
Files: 30; besides SKILL.md
Updated: Oct 2026; last repo commit

lark-whiteboard handles whiteboards embedded in Lark documents. It exports a board as a preview image, an SVG, the original Mermaid or PlantUML source, or raw nodes. It also writes to a board from Mermaid, PlantUML, SVG or Lark's native format. It loads when you ask to look at, export or edit a whiteboard.

For new, complex diagrams it follows a longer creation workflow with 16 scene guides, such as flowchart, architecture, swimlane, fishbone and funnel. Before it starts, it runs lark-cli --version and npx -y @larksuite/whiteboard-cli@^0.2.13 -v, which downloads and runs a second package. Overwriting a non-empty board rebuilds the whole board, so SKILL.md says to confirm first.

Good for

Teams that keep architecture and flow diagrams in Lark docs
Anyone who has Mermaid or PlantUML code and wants it on a whiteboard
Designers who want Claude to rebuild a board from a description

Install lark-whiteboard

Claude Code

Copy this prompt.

Install the lark-whiteboard skill in Claude Code. Run this command:

npx @larksuite/cli@latest install

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

This skill only gives Claude instructions for the lark-cli command line, so install the CLI first, then the skills, then sign in. The skills command adds the whole larksuite/cli set, which includes lark-shared, the skill this one reads first for sign-in and permissions.

From the project README. Source.

What's in the skill

When it loads

飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。

Sections in SKILL.md

快速决策
A. 只读 · 查看 / 导出（不改画板）
B. 写入 · 创作 / 编辑（会改画板，命中即停）
Shortcuts
不在本 skill 范围

Key facts

Author: Lark Suite (larksuite)
Repository: larksuite/cli, folder skills/lark-whiteboard
Installs on skills.sh: 475,682 as of 2026-11-02
GitHub stars: 17,911 for the whole larksuite/cli repo, 2026-11-02
License: MIT
Last repo commit: 2026-10-30
What is inside: 30 bundled reference pages besides SKILL.md: element, route and scene guides; no scripts
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass

What it includes

Exports a board as image, SVG, source code or raw nodes
Read-only; changes nothing on the board.
Try: “Export the whiteboard in this doc as an image.”
Files · +export
Writes to a board from Mermaid, PlantUML, SVG or native format
Can append or overwrite; overwriting rebuilds the whole board.
Try: “Put this Mermaid flowchart on the board.”
Write · +update
Builds complex diagrams from scratch
The workflow reference picks a route (DSL, Mermaid or SVG) and a scene guide, writes diagram files to ./diagrams/<timestamp>/, then writes the board.
Runs code · Creation workflow
Changes or adds to an existing board
SVG edits to an existing board can lose detail, so SKILL.md asks for confirmation.
Write · Editing workflow
16 scene guides: flowchart, architecture, swimlane, treemap and more
Layout and style rules Claude follows for each type.
Read · Scene guides
Runs lark-cli --version and the whiteboard-cli package
Uses npx to fetch and run @larksuite/whiteboard-cli before work starts.
Runs code · Version check

From the official docs

Permissions

Medium risk

Claude can replace the contents of a whiteboard in your Lark docs and runs an extra npm package to do it. Export the board first and approve the npx step only if you trust it.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It acts as you in Lark after you sign in
The repo README warns that the agent works under your user identity within the authorized scope. Grant only the scopes you need and read commands before you approve them. github.com
Overwriting rebuilds the whole board
SKILL.md says to confirm before replacing a board that already has content. Export it first if you want a copy. github.com
It runs a second package from npm
The start-up check fetches and runs @larksuite/whiteboard-cli. Approve it only if you trust that package. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	The skill has no read-only switch. Sign in with a narrow scope list, for example lark-cli auth login --domain <name>, so the agent cannot reach more than you intend.
Talks to	Lark/Feishu Open Platform API calls made by lark-cli. Your AI provider receives whatever Claude reads from Lark. npm, to fetch @larksuite/whiteboard-cli
Sign-in and keys	lark-cli stores credentials in the OS keychain, per the repo README.
Scopes	Claude runs lark-cli commands in your terminal After you sign in, commands run as your Lark or Feishu user within the permissions you granted Can overwrite whiteboards in your documents Runs a second npm package through npx (@larksuite/whiteboard-cli) Can save exported images and diagram files (./diagrams/<timestamp>/ in the creation workflow) to your machine

Questions

How do I install lark-whiteboard?

Use the install box at the top of this page. The box lists three steps: install the Lark CLI, add the Lark skills, then set up an app and sign in. The skill is only instructions, so Claude cannot use it until lark-cli is installed and you are signed in.

Do I need a Lark account to use lark-whiteboard?

Yes. You need a Lark or Feishu account, plus an app set up with lark-cli config init. The README then has you sign in with lark-cli auth login --recommend. There is no separate API key to paste.

Does lark-whiteboard install anything extra?

It tells Claude to run npx -y @larksuite/whiteboard-cli@^0.2.13 -v as a check before work. That downloads and runs the whiteboard package from npm, in addition to lark-cli.

Can it edit text inside the doc around the whiteboard?

No. SKILL.md leaves document text to lark-doc and embedded sheets or tables to lark-sheets and lark-base. Creating a whiteboard inside a doc is a lark-doc job too.

Is lark-whiteboard safe?

Use it with care. It can overwrite a whiteboard and runs an extra npm package. The repo README warns that after you authorize Lark permissions the agent acts under your user identity and that model mistakes or prompt injection can cause real changes.

Information

updated Nov 2, 2026

Repository: larksuite/cli
Folder: skills/lark-whiteboard

larksuite/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

larksuite/cli README · github.com
lark-whiteboard SKILL.md · github.com
lark-whiteboard workflow reference · github.com
lark-skill-maker SKILL.md · github.com