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.