SkillsMar 30, 2026·1 min read

Lark CLI Skill: Whiteboard — Chart & DSL Rendering

Lark/Feishu CLI skill for whiteboards. Render charts and diagrams using DSL-based whiteboard creation.

TL;DR
A Lark/Feishu CLI skill that renders charts and diagrams on whiteboards using DSL-based definitions.
§01

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.

§02

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.

§03

How to use

  1. Install the Lark CLI skill in your Claude Code or Gemini CLI environment.
  2. Write a chart definition using the supported DSL syntax (Mermaid, PlantUML, or custom Lark DSL).
  3. Run the skill command to render the chart on a specified Lark whiteboard.
  4. Share the whiteboard link with your team for review and collaboration.
§04

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
§05

Related on TokRepo

§06

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

What DSL formats are supported?+

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.

Does this work with Feishu (Chinese version)?+

Yes. The skill works with both Lark (international) and Feishu (China) instances. Configure the correct API endpoint for your region in the skill settings.

Can I update an existing whiteboard chart?+

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.

What types of charts are supported?+

The skill supports flowcharts, sequence diagrams, bar charts, pie charts, mind maps, and organizational charts. The chart type is specified in the DSL definition.

Can this skill run in CI/CD pipelines?+

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)
🙏

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

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets