Lark CLI Skill: Whiteboard — Chart & DSL Rendering
Lark/Feishu CLI skill for whiteboards. Render charts and diagrams using DSL-based whiteboard creation.
What it is
This CLI skill extends Lark (Feishu) with the ability to render charts and diagrams on whiteboards using a DSL (Domain-Specific Language). It turns text-based descriptions into visual content on Lark whiteboards programmatically.
The skill targets teams using Lark for collaboration who want to automate the creation of diagrams, flowcharts, and data visualizations directly from their development workflows or CI pipelines.
The project is actively maintained and suitable for both individual developers and teams looking to integrate it into their existing toolchain. Documentation and community support are available for onboarding.
How it saves time or tokens
Manually creating charts and diagrams in a whiteboard tool is time-consuming and hard to version control. This skill lets you define visuals as code, generate them with a command, and update them by changing the DSL definition. The chart-as-code approach makes diagrams reproducible and diffable in version control.
For teams evaluating multiple tools in the same category, the clear documentation and active community reduce the time spent on research and troubleshooting. Getting started takes minutes rather than hours of configuration.
How to use
- Install the Lark CLI skill in your Claude Code or Gemini CLI environment.
- Write a chart definition using the supported DSL syntax (Mermaid, PlantUML, or custom Lark DSL).
- Run the skill command to render the chart on a specified Lark whiteboard.
- Share the whiteboard link with your team for review and collaboration.
Example
# Chart definition for Lark whiteboard
chart:
type: flowchart
title: 'CI/CD Pipeline'
nodes:
- id: build
label: 'Build'
- id: test
label: 'Test'
- id: deploy
label: 'Deploy'
edges:
- from: build
to: test
- from: test
to: deploy
style:
theme: corporate
direction: LR
# Render the chart on a Lark whiteboard
lark-cli whiteboard render --config chart.yaml --board-id abc123
Related on TokRepo
- AI Tools for Documentation — Documentation and diagram generation tools.
- AI Tools for No-Code — Visual creation tools with code-based alternatives.
Common pitfalls
- Not authenticating with Lark API before running the skill. You need a valid Lark app token with whiteboard write permissions.
- Using complex nested charts that exceed whiteboard rendering limits. Keep charts to under 50 nodes for reliable rendering.
- Forgetting to set the board-id parameter, which causes the skill to create a new whiteboard instead of updating an existing one.
- Applying the skill without reading the documentation first. Each skill has specific prerequisites and configuration requirements that affect the quality of results.
Frequently Asked Questions
The skill supports Mermaid diagram syntax, PlantUML, and a custom YAML-based DSL for chart definitions. Mermaid is recommended for most use cases due to its widespread adoption and readable syntax.
Yes. The skill works with both Lark (international) and Feishu (China) instances. Configure the correct API endpoint for your region in the skill settings.
Yes. Specify the board-id and node-id of the existing chart. The skill replaces the chart content while preserving the whiteboard layout and other elements.
The skill supports flowcharts, sequence diagrams, bar charts, pie charts, mind maps, and organizational charts. The chart type is specified in the DSL definition.
Yes. The CLI-based interface makes it suitable for CI/CD integration. Generate architecture diagrams or deployment status charts automatically after each deployment.
Citations (3)
- Lark Developer Docs— Lark Open Platform API for whiteboards
- Mermaid Official Site— Mermaid diagram syntax for chart definitions
- PlantUML— Diagram as code methodology
Related on TokRepo
Source & Thanks
Created by LarkSuite. Licensed under MIT. larksuite/cli — 4,100+ GitHub stars
Part of the Lark CLI Official Skills Collection on TokRepo.
Discussion
Related Assets
code-simplifier — Anthropic Official Cleanup Subagent
Anthropic's open-source post-task cleanup agent that Boris Cherny runs after every Claude Code session. Refactors for clarity without changing behavior.
Ralph Wiggum — Anthropic Official Autonomous Loop Plugin
Official Anthropic plugin that turns Claude Code into an autonomous loop. Adds /ralph-loop and /cancel-ralph for long-running self-improving task execution.