lark-whiteboard

Generate and render Feishu whiteboard diagrams from DSL or Mermaid inputs.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/eatbreads/.agents --skill lark-whiteboard-eatbreads
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-whiteboard
Source: https://github.com/eatbreads/.agents/tree/main/skills/lark-whiteboard
Command: npx skills add https://github.com/eatbreads/.agents --skill lark-whiteboard-eatbreads

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a structured, repeatable way to create, render, and optionally upload high-quality diagrams into Feishu (Lark) whiteboards, eliminating manual drawing and ad-hoc positioning errors for architecture diagrams, charts, and other visual assets.

Core Features & Use Cases

  • Dual rendering paths: support Mermaid text for auto-layout diagrams and a precise DSL + JSON path for fully controlled layouts.
  • Scripted generation for precision: templates and Node.js script patterns for fishbone, flywheel, funnel, treemap, pyramid and chart coordinate calculations to avoid overlaps and ensure visual correctness.
  • Safe upload workflow: commands and mandatory dry-run checks before overwriting an existing Feishu whiteboard token; supports token extraction from docs and user-confirmed overwrite behavior.
  • Use case: convert a design spec into a DSL JSON, render to PNG with the whiteboard CLI, validate visually, and upload to a Feishu doc after obtaining user consent for overwrites.

Quick Start

Create a DSL or Mermaid source, render it to PNG using the whiteboard CLI, run a dry-run upload to inspect changes, and only upload to the target Feishu whiteboard token after the user confirms overwrite.

Frequently Asked Questions about lark-whiteboard

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

FAQPage Schema
How do I generate diagrams on Feishu whiteboards from Mermaid or DSL inputs?▼

You can generate Feishu whiteboard diagrams by providing Mermaid text for auto-layout or a DSL JSON for precise coordinate control, then rendering the output to PNG using the whiteboard CLI.

Can I automate architecture diagram and chart creation for Feishu docs?▼

Yes, you can automate architecture diagram and chart creation by using Node.js script templates to calculate coordinates for bar, line, pie, and complex visuals like fishbone and treemap before rendering.

Do I need Node.js and lark-cli to render whiteboard visuals?▼

Yes, rendering whiteboard visuals requires Node.js 18+, lark-cli, and the @larksuite/whiteboard-cli package to execute the diagram generation and PNG export processes.

What is the safest way to upload generated diagrams to a Feishu whiteboard token?▼

The safest upload method involves running a mandatory dry-run overwrite check to inspect changes, extracting the target Feishu whiteboard token, and only uploading after explicit user confirmation.

Does this approach support both auto-layout flowcharts and manually positioned mindmaps?▼

Yes, it supports auto-layout flowcharts and mindmaps via Mermaid text, while also enabling fully controlled manual positioning for funnels, pyramids, and flywheels through the DSL JSON path.

Why do my script-generated diagram coordinates overlap on the Feishu whiteboard?▼

Overlapping diagram coordinates occur when manual positioning lacks precision; using the provided Node.js script templates for coordinate calculation ensures visual correctness and prevents overlaps.