lark-whiteboard

Generates editable cloud-native network topologies and routing for Kubernetes and beyond, with built-in YAMLlinting, conflict detection and correction, plus optional GitOps-style export for CI/CD-driven updates. It handles complex scenarios like overlapping CIDR ranges and multi-cluster setups gracefully, ensuring scalable and reliable deployments.

Updated Sep 4, 2025
One-click install
npx skills add https://github.com/ykai55/dotfiles --skill lark-whiteboard-ykai55
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-whiteboard
Source: https://github.com/ykai55/dotfiles/tree/main/opencode/skills/lark-whiteboard
Command: npx skills add https://github.com/ykai55/dotfiles --skill lark-whiteboard-ykai55

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, @larksuite/whiteboard-cli, and includes references (resource) components.

What problem does it solve?

当你需要在飞书云文档中快速绘制白板图表(架构图、流程图、思维导图等)时,这个 Skill 解决你从“需求描述”到“可直接渲染并可上传”的落地成本问题。

Core Features & Use Cases

  • 根据图表类型选择路径:自动在 Mermaid(思维导图/时序图/类图/饼图/流程图)与 DSL(其他类型,如架构图、对比图等)之间路由生成。
  • 生成完整 DSL 并渲染 PNG:输出包含颜色与布局的 DSL JSON,并按检查清单进行审查与最多两轮修复后交付。
  • 支持上传飞书画板:在获得文档画板 Token 后,将渲染结果写入飞书画板;对“非空覆盖”提供强制 Dry Run 探测与用户确认拦截。
  • 复杂图表优先脚本生成:鱼骨图/飞轮图/柱状图/折线图等使用脚本计算坐标,减少手工坐标导致的重叠与连线穿模。

Quick Start

让它根据你提供的图表类型与内容生成白板图表(例如“画一个微服务架构图并上传到我指定的飞书画板 Token”)。

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 for Feishu Whiteboard from Mermaid or DSL?▼

To generate Feishu Whiteboard diagrams, you provide Mermaid or DSL inputs and the system routes the diagram type, producing complete JSON with layout and color while rendering a PNG for review.

What diagram types are supported for whiteboard upload via DSL scenes?▼

Supported DSL scenes include architecture, comparison, milestone, organization, fishbone, funnel, pyramid, treemap, flywheel, and bar/line charts, while Mermaid parsing handles mind maps, sequence diagrams, and flowcharts.

Do I need Node.js and lark-cli to upload diagrams to an existing Feishu whiteboard?▼

Yes, uploading rendered diagrams to an existing Feishu whiteboard requires Node.js 18+ and lark-cli, along with a detected document whiteboard token to write the rendering results directly.

How does the system prevent overwriting non-empty Feishu whiteboards?▼

The system enforces safety guardrails for overwriting non-empty whiteboards by requiring dry-run overwrite checks with node deletion detection and prompting for user confirmation before proceeding.

How are precise coordinates calculated for complex charts like fishbone or bar charts?▼

Complex charts like fishbone, flywheel, bar, and line charts use script-based coordinate generation to calculate precise geometry, reducing manual coordinate errors like overlapping elements and crossing connections.