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.