Skip to content
Back to search

beautiful-feishu-whiteboard

35 curated colour palette styles for building beautiful, editable Feishu / Lark (飞书) whiteboards. An agent skill.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zarazhangrui--beautiful-feishu-whiteboard/badge.svg)](/listings/zarazhangrui--beautiful-feishu-whiteboard)

HTML

<a href="/listings/zarazhangrui--beautiful-feishu-whiteboard"><img src="/api/listings/zarazhangrui--beautiful-feishu-whiteboard/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Tell your agent** (Claude Code, etc.):

> "Install the **beautiful-feishu-whiteboard** skill from > `github.com/zarazhangrui/beautiful-feishu-whiteboard`."

Or run the installer yourself:

# project level (./.claude/skills or your agent's skills dir)
npx skills add zarazhangrui/beautiful-feishu-whiteboard

# or globally (available in every project)
npx skills add zarazhangrui/beautiful-feishu-whiteboard -g

Or install manually (clone into your agent's skills folder):

git clone https://github.com/zarazhangrui/beautiful-feishu-whiteboard \
  ~/.claude/skills/beautiful-feishu-whiteboard

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 81 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: beautiful-feishu-whiteboard
  3. version: 1.1.1
  4. description: >
  5. A library of 35 curated colour palette styles for building beautiful, editable Feishu / Lark
  6. (飞书) whiteboards from SVG. Use this whenever the user wants to create or draw a Feishu whiteboard,
  7. infographic, diagram, poster, or visual explainer and wants it to look polished, on brand, or in a
  8. particular aesthetic, or when they name a style. The agent figures out what board the user wants,
  9. asks about the visual vibe, picks a fitting style from the catalogue, generates an editable Feishu
  10. whiteboard, returns the doc link and the rendered image, and offers to switch styles. Requires
  11. lark-cli (npm @larksuite/cli) installed and authenticated, and a Feishu/Lark account.
  12. ---
  13. # Beautiful Feishu Whiteboard
  14. A design system skill: **35 colour palette styles** plus the verified **hard rules** of the Feishu
  15. SVG whiteboard medium, so you can build gorgeous, on brand, _editable_ whiteboards.
  16. This is **not** an auto layout chart generator. **You** compose the layout. A template gives you a
  17. **palette and mood**; [`RULES.md`](RULES.md) gives you the medium's hard limits. The board you
  18. produce is a real, editable Feishu whiteboard inside a doc, not a screenshot.
  19. ## When to use
  20. - The user wants a Feishu / Lark whiteboard, infographic, diagram, poster, or visual explainer that
  21. should look good, branded, or in a specific aesthetic.
  22. - The user names a style, or points at one of the templates.
  23. - The user gives content ("explain X as a whiteboard", "turn this into a board") and wants it
  24. visual and editable inside Feishu.
  25. ## Step 0: prerequisites (check before doing anything)
  26. Run [`scripts/preflight.sh`](scripts/preflight.sh), or check manually:
  27. - **Node 20 or newer.**
  28. - **`lark-cli`** (npm package **`@larksuite/cli`**), installed **and authenticated**. If missing:
  29. `npm install -g @larksuite/cli`, then `lark-cli config init` (scan the QR), then `lark-cli auth login`.
  30. - **`@larksuite/whiteboard-cli`**, used via `npx`, auto downloads, no install needed.
  31. - A **Feishu / Lark account**. The board is written to the user's own tenant.
  32. If `lark-cli` is missing or not authenticated, tell the user exactly how to install and
  33. authenticate, then stop. You cannot write a board without it.
  34. ## How to run the conversation
  35. 1. **Understand the board.** Find out what the user wants on it: the content, the purpose, the
  36. audience. If it is unclear, ask one short question before building.
  37. 2. **Ask about the vibe.** Ask the user what visual style they want, for example playful or
  38. professional, any colour or mood preference, or a brand to match. Offer to pick for them if they
  39. have no preference. If they already named a style, skip ahead.
  40. 3. **Pick a style.** Use [`CATALOG.md`](CATALOG.md) to match the content type and the requested vibe
  41. and formality to one of the 35 styles. The catalogue lists each style's palette signature, so
  42. **choose from it alone** — don't open several `design.md` files to compare. Tell the user which
  43. style you chose and why, in one line.
  44. 4. **Build it.** Read [`RULES.md`](RULES.md) and **only the one** chosen
  45. [`templates/<slug>/design.md`](templates/), then:
  46. - Compose the SVG in a logical space about 1600 to 1700 wide, in that palette, with **native
  47. shapes only** (rect, rounded rect, circle, ellipse, connectors, text). Lay the content out
  48. however reads best. Every label is a `<text>`; never set `font-family`.
  49. - **Only the content goes on the board, never the instruction behind it.** Do not print the
  50. user's prompt, scope notes, source citations, the chosen style name, or any "summary of… /
  51. 来源… / 风格…" meta line onto the canvas — that looks like a homework header. Such context
  52. belongs in your chat reply. (See the "Never echo the user's instructions" rule in `RULES.md`.)
  53. - **Render it, then look at the image and correct yourself**: fix text overflow, tight margins or
  54. padding, numerals touching edges, accidental overlaps, and clipping. Iterate render, view, fix
  55. until it is clean. (Commands and the full checklist are in `RULES.md`.) **When fixing, edit the
  56. `.svg` file in place with small targeted edits** (move a box, widen a panel, rewrap a label) —
  57. do not regenerate the whole SVG each pass; and batch the fixes you see in one view into a single
  58. edit pass before re-rendering, rather than one fix per render.
  59. - Write it into a Feishu doc as an editable whiteboard, then view the live board image too and fix
  60. any remaining layout issues.
  61. 5. **Deliver.** Give the user **both**: the **Feishu doc link** and the **rendered image** itself, so
  62. they can see it without opening the doc. Then tell them they can **switch to a different style**
  63. any time, and you will re render the same content in the new palette.
  64. ## Files
  65. - **[`RULES.md`](RULES.md)**: the hard rules and the exact build, write, and verify commands. Always read this.
  66. - **[`CATALOG.md`](CATALOG.md)**: every style with its vibe, formality, and what it is good for. Use it to choose.
  67. - **[`templates/<slug>/design.md`](templates/)**: one per style, the colour palette and how to use it.
  68. - **[`scripts/preflight.sh`](scripts/preflight.sh)**: dependency and auth check.
README.md · README · 182 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Beautiful Feishu Whiteboard
  2. [中文 README](./README.zh.md)
  3. **A library of 35 curated colour palette styles for building gorgeous, *editable* Feishu / Lark
  4. (飞书) whiteboards.**
  5. See the [Feishu doc version of this intro](https://bytedance.us.larkoffice.com/docx/AldcdypvjoEqQDxcSVeu37ixs0d) (with usage-scenario showcases).
  6. This is an agent **skill** (for Claude Code and other agents that read `SKILL.md`). It is not an
  7. auto layout chart tool. Your agent composes the layout, and these templates give it a tasteful
  8. **colour palette and mood** plus the whiteboard medium's hard rendering rules. The result is a real,
  9. **editable** Feishu whiteboard inside a doc, not a screenshot.
  10. > Built from hard won, on board verified knowledge of what the Feishu SVG whiteboard renderer can and
  11. > cannot do (native shapes only, no opacity, the text colour export quirk, and more), all captured in
  12. > [`RULES.md`](RULES.md).
  13. ## Gallery
  14. Every style renders the **same content**, the three stages of LLM training, so you can compare
  15. palettes directly. The 35 styles are grouped from **restrained** to **bold**. Click a name to
  16. open its template.
  17. ### Restrained
  18. <table>
  19. <tr>
  20. <td width="50%"><a href="templates/avocado-press/"><img src="assets/styles/avocado-press.png" alt="Avocado Press"/></a><br/><sub><a href="templates/avocado-press/"><b>Avocado Press</b></a></sub></td>
  21. <td width="50%"><a href="templates/grove/"><img src="assets/styles/grove.png" alt="Grove"/></a><br/><sub><a href="templates/grove/"><b>Grove</b></a></sub></td>
  22. </tr>
  23. <tr>
  24. <td width="50%"><a href="templates/jade-lens/"><img src="assets/styles/jade-lens.png" alt="Jade Lens"/></a><br/><sub><a href="templates/jade-lens/"><b>Jade Lens</b></a></sub></td>
  25. <td width="50%"><a href="templates/long-table/"><img src="assets/styles/long-table.png" alt="Long Table"/></a><br/><sub><a href="templates/long-table/"><b>Long Table</b></a></sub></td>
  26. </tr>
  27. <tr>
  28. <td width="50%"><a href="templates/macchiato/"><img src="assets/styles/macchiato.png" alt="Macchiato"/></a><br/><sub><a href="templates/macchiato/"><b>Macchiato</b></a></sub></td>
  29. <td width="50%"><a href="templates/monochrome/"><img src="assets/styles/monochrome.png" alt="Monochrome"/></a><br/><sub><a href="templates/monochrome/"><b>Monochrome</b></a></sub></td>
  30. </tr>
  31. <tr>
  32. <td width="50%"><a href="templates/papier-bleu/"><img src="assets/styles/papier-bleu.png" alt="Papier Bleu"/></a><br/><sub><a href="templates/papier-bleu/"><b>Papier Bleu</b></a></sub></td>
  33. <td width="50%"><a href="templates/reading-room/"><img src="assets/styles/reading-room.png" alt="Reading Room"/></a><br/><sub><a href="templates/reading-room/"><b>Reading Room</b></a></sub></td>
  34. </tr>
  35. <tr>
  36. <td width="50%"><a href="templates/salmon-stamp/"><img src="assets/styles/salmon-stamp.png" alt="Salmon Stamp"/></a><br/><sub><a href="templates/salmon-stamp/"><b>Salmon Stamp</b></a></sub></td>
  37. </tr>
  38. </table>
  39. ### Balanced
  40. <table>
  41. <tr>
  42. <td width="50%"><a href="templates/apricot-arc/"><img src="assets/styles/apricot-arc.png" alt="Apricot Arc"/></a><br/><sub><a href="templates/apricot-arc/"><b>Apricot Arc</b></a></sub></td>
  43. <td width="50%"><a href="templates/berry-pop/"><img src="assets/styles/berry-pop.png" alt="Berry Pop"/></a><br/><sub><a href="templates/berry-pop/"><b>Berry Pop</b></a></sub></td>
  44. </tr>
  45. <tr>
  46. <td width="50%"><a href="templates/bold-poster/"><img src="assets/styles/bold-poster.png" alt="Bold Poster"/></a><br/><sub><a href="templates/bold-poster/"><b>Bold Poster</b></a></sub></td>
  47. <td width="50%"><a href="templates/checker-bloom/"><img src="assets/styles/checker-bloom.png" alt="Checker Bloom"/></a><br/><sub><a href="templates/checker-bloom/"><b>Checker Bloom</b></a></sub></td>
  48. </tr>
  49. <tr>
  50. <td width="50%"><a href="templates/cobalt-bloom/"><img src="assets/styles/cobalt-bloom.png" alt="Cobalt Bloom"/></a><br/><sub><a href="templates/cobalt-bloom/"><b>Cobalt Bloom</b></a></sub></td>
  51. <td width="50%"><a href="templates/coral/"><img src="assets/styles/coral.png" alt="Coral"/></a><br/><sub><a href="templates/coral/"><b>Coral</b></a></sub></td>
  52. </tr>
  53. <tr>
  54. <td width="50%"><a href="templates/cut-bloom/"><img src="assets/styles/cut-bloom.png" alt="Cut Bloom"/></a><br/><sub><a href="templates/cut-bloom/"><b>Cut Bloom</b></a></sub></td>
  55. <td width="50%"><a href="templates/editorial-forest/"><img src="assets/styles/editorial-forest.png" alt="Editorial Forest"/></a><br/><sub><a href="templates/editorial-forest/"><b>Editorial Forest</b></a></sub></td>
  56. </tr>
  57. <tr>
  58. <td width="50%"><a href="templates/lime-slab/"><img src="assets/styles/lime-slab.png" alt="Lime Slab"/></a><br/><sub><a href="templates/lime-slab/"><b>Lime Slab</b></a></sub></td>
  59. <td width="50%"><a href="templates/linen-cut/"><img src="assets/styles/linen-cut.png" alt="Linen Cut"/></a><br/><sub><a href="templates/linen-cut/"><b>Linen Cut</b></a></sub></td>
  60. </tr>
  61. <tr>
  62. <td width="50%"><a href="templates/pin-and-paper/"><img src="assets/styles/pin-and-paper.png" alt="Pin & Paper"/></a><br/><sub><a href="templates/pin-and-paper/"><b>Pin & Paper</b></a></sub></td>
  63. <td width="50%"><a href="templates/raw-grid/"><img src="assets/styles/raw-grid.png" alt="Raw Grid"/></a><br/><sub><a href="templates/raw-grid/"><b>Raw Grid</b></a></sub></td>
  64. </tr>
  65. <tr>
  66. <td width="50%"><a href="templates/riptide-cobalt/"><img src="assets/styles/riptide-cobalt.png" alt="Riptide Cobalt"/></a><br/><sub><a href="templates/riptide-cobalt/"><b>Riptide Cobalt</b></a></sub></td>
  67. <td width="50%"><a href="templates/soft-editorial/"><img src="assets/styles/soft-editorial.png" alt="Soft Editorial"/></a><br/><sub><a href="templates/soft-editorial/"><b>Soft Editorial</b></a></sub></td>
  68. </tr>
  69. <tr>
  70. <td width="50%"><a href="templates/violet-marker/"><img src="assets/styles/violet-marker.png" alt="Violet Marker"/></a><br/><sub><a href="templates/violet-marker/"><b>Violet Marker</b></a></sub></td>
  71. </tr>
  72. </table>
  73. ### Bold
  74. <table>
  75. <tr>
  76. <td width="50%"><a href="templates/block-frame/"><img src="assets/styles/block-frame.png" alt="BlockFrame"/></a><br/><sub><a href="templates/block-frame/"><b>BlockFrame</b></a></sub></td>
  77. <td width="50%"><a href="templates/burst-panel/"><img src="assets/styles/burst-panel.png" alt="Burst Panel"/></a><br/><sub><a href="templates/burst-panel/"><b>Burst Panel</b></a></sub></td>
  78. </tr>
  79. <tr>
  80. <td width="50%"><a href="templates/confetti-wedge/"><img src="assets/styles/confetti-wedge.png" alt="Confetti Wedge"/></a><br/><sub><a href="templates/confetti-wedge/"><b>Confetti Wedge</b></a></sub></td>
  81. <td width="50%"><a href="templates/court-press/"><img src="assets/styles/court-press.png" alt="Court Press"/></a><br/><sub><a href="templates/court-press/"><b>Court Press</b></a></sub></td>
  82. </tr>
  83. <tr>
  84. <td width="50%"><a href="templates/crayon-stack/"><img src="assets/styles/crayon-stack.png" alt="Crayon Stack"/></a><br/><sub><a href="templates/crayon-stack/"><b>Crayon Stack</b></a></sub></td>
  85. <td width="50%"><a href="templates/grove-block/"><img src="assets/styles/grove-block.png" alt="Grove Block"/></a><br/><sub><a href="templates/grove-block/"><b>Grove Block</b></a></sub></td>
  86. </tr>
  87. <tr>
  88. <td width="50%"><a href="templates/mint-brut/"><img src="assets/styles/mint-brut.png" alt="Mint Brut"/></a><br/><sub><a href="templates/mint-brut/"><b>Mint Brut</b></a></sub></td>
  89. <td width="50%"><a href="templates/neo-grid-bold/"><img src="assets/styles/neo-grid-bold.png" alt="Neo-Grid Bold"/></a><br/><sub><a href="templates/neo-grid-bold/"><b>Neo-Grid Bold</b></a></sub></td>
  90. </tr>
  91. <tr>
  92. <td width="50%"><a href="templates/riso-brut/"><img src="assets/styles/riso-brut.png" alt="Riso Brut"/></a><br/><sub><a href="templates/riso-brut/"><b>Riso Brut</b></a></sub></td>
  93. <td width="50%"><a href="templates/specimen-bold/"><img src="assets/styles/specimen-bold.png" alt="Specimen Bold"/></a><br/><sub><a href="templates/specimen-bold/"><b>Specimen Bold</b></a></sub></td>
  94. </tr>
  95. <tr>
  96. <td width="50%"><a href="templates/stencil-tablet/"><img src="assets/styles/stencil-tablet.png" alt="Stencil & Tablet"/></a><br/><sub><a href="templates/stencil-tablet/"><b>Stencil & Tablet</b></a></sub></td>
  97. </tr>
  98. </table>
  99. ---
  100. ## Install
  101. **Tell your agent** (Claude Code, etc.):
  102. > "Install the **beautiful-feishu-whiteboard** skill from
  103. > `github.com/zarazhangrui/beautiful-feishu-whiteboard`."
  104. Or run the installer yourself:
  105. ```bash
  106. # project level (./.claude/skills or your agent's skills dir)
  107. npx skills add zarazhangrui/beautiful-feishu-whiteboard
  108. # or globally (available in every project)
  109. npx skills add zarazhangrui/beautiful-feishu-whiteboard -g
  110. ```
  111. Or install manually (clone into your agent's skills folder):
  112. ```bash
  113. git clone https://github.com/zarazhangrui/beautiful-feishu-whiteboard \
  114. ~/.claude/skills/beautiful-feishu-whiteboard
  115. ```
  116. ## Requirements
  117. - **Node.js 20 or newer**
  118. - **A Feishu / Lark account.** Boards are written into your own tenant.
  119. - **`lark-cli`** (npm `@larksuite/cli`), installed and authenticated:
  120. ```bash
  121. npm install -g @larksuite/cli
  122. lark-cli config init # first run: scan the QR code
  123. lark-cli auth login # authorize your Feishu/Lark account
  124. ```
  125. - **`@larksuite/whiteboard-cli`**, used via `npx`, downloads automatically, no install needed.
  126. Run the bundled check any time: `bash scripts/preflight.sh`
  127. ## Use it
  128. Once installed, just ask your agent in plain language. You can name a style or describe a vibe:
  129. > - "Make a **Feishu whiteboard** explaining our onboarding flow, in the **Riso Brut** style."
  130. > - "Turn this doc into a visual **board** in Feishu, minimal **cobalt** look."
  131. > - "Draw the system architecture as a Feishu whiteboard, **playful candy** colours."
  132. > - "Explain the 3 LLM training stages as a board."
  133. Your agent will: ask what the board is for and what vibe you want, pick a fitting style from the
  134. [catalogue](CATALOG.md), compose the diagram with native shapes, render it and self correct
  135. (overflow, margins, overlaps), write it into a Feishu doc as an editable whiteboard, then send you
  136. **both the doc link and the image**. You can switch to a different style any time.
  137. ## How it works
  138. - **`SKILL.md`**: the agent entry point. When to use, the preflight, and the conversation flow
  139. (understand the board, ask the vibe, pick a style, build, deliver the link and image, offer to switch).
  140. - **`CATALOG.md`**: every style with its vibe, formality level, and what it is good for, so the agent
  141. can pick a style that fits the content.
  142. - **`RULES.md`**: the medium's hard limits (native shapes only, no opacity, no gradients or blur, the
  143. text colour export caveat) and the exact `lark-cli` and `whiteboard-cli` commands.
  144. - **`templates/<slug>/design.md`**: one per style, just the palette and how to use its colours. The
  145. agent is free to lay out the content however reads best; the template only constrains colour and mood.
  146. ## License
  147. [MIT](LICENSE) (c) Zara Zhang ([@zarazhangrui](https://github.com/zarazhangrui))
  148. Built on Feishu/Lark's `@larksuite/cli` and `@larksuite/whiteboard-cli`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.