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.
Badge for your README
Markdown
[](/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
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)
- ---
- name: beautiful-feishu-whiteboard
- version: 1.1.1
- description: >
- A library of 35 curated colour palette styles for building beautiful, editable Feishu / Lark
- (飞书) whiteboards from SVG. Use this whenever the user wants to create or draw a Feishu whiteboard,
- infographic, diagram, poster, or visual explainer and wants it to look polished, on brand, or in a
- particular aesthetic, or when they name a style. The agent figures out what board the user wants,
- asks about the visual vibe, picks a fitting style from the catalogue, generates an editable Feishu
- whiteboard, returns the doc link and the rendered image, and offers to switch styles. Requires
- lark-cli (npm @larksuite/cli) installed and authenticated, and a Feishu/Lark account.
- ---
- # Beautiful Feishu Whiteboard
- A design system skill: **35 colour palette styles** plus the verified **hard rules** of the Feishu
- SVG whiteboard medium, so you can build gorgeous, on brand, _editable_ whiteboards.
- This is **not** an auto layout chart generator. **You** compose the layout. A template gives you a
- **palette and mood**; [`RULES.md`](RULES.md) gives you the medium's hard limits. The board you
- produce is a real, editable Feishu whiteboard inside a doc, not a screenshot.
- ## When to use
- - The user wants a Feishu / Lark whiteboard, infographic, diagram, poster, or visual explainer that
- should look good, branded, or in a specific aesthetic.
- - The user names a style, or points at one of the templates.
- - The user gives content ("explain X as a whiteboard", "turn this into a board") and wants it
- visual and editable inside Feishu.
- ## Step 0: prerequisites (check before doing anything)
- Run [`scripts/preflight.sh`](scripts/preflight.sh), or check manually:
- - **Node 20 or newer.**
- - **`lark-cli`** (npm package **`@larksuite/cli`**), installed **and authenticated**. If missing:
- `npm install -g @larksuite/cli`, then `lark-cli config init` (scan the QR), then `lark-cli auth login`.
- - **`@larksuite/whiteboard-cli`**, used via `npx`, auto downloads, no install needed.
- - A **Feishu / Lark account**. The board is written to the user's own tenant.
- If `lark-cli` is missing or not authenticated, tell the user exactly how to install and
- authenticate, then stop. You cannot write a board without it.
- ## How to run the conversation
- 1. **Understand the board.** Find out what the user wants on it: the content, the purpose, the
- audience. If it is unclear, ask one short question before building.
- 2. **Ask about the vibe.** Ask the user what visual style they want, for example playful or
- professional, any colour or mood preference, or a brand to match. Offer to pick for them if they
- have no preference. If they already named a style, skip ahead.
- 3. **Pick a style.** Use [`CATALOG.md`](CATALOG.md) to match the content type and the requested vibe
- and formality to one of the 35 styles. The catalogue lists each style's palette signature, so
- **choose from it alone** — don't open several `design.md` files to compare. Tell the user which
- style you chose and why, in one line.
- 4. **Build it.** Read [`RULES.md`](RULES.md) and **only the one** chosen
- [`templates/<slug>/design.md`](templates/), then:
- - Compose the SVG in a logical space about 1600 to 1700 wide, in that palette, with **native
- shapes only** (rect, rounded rect, circle, ellipse, connectors, text). Lay the content out
- however reads best. Every label is a `<text>`; never set `font-family`.
- - **Only the content goes on the board, never the instruction behind it.** Do not print the
- user's prompt, scope notes, source citations, the chosen style name, or any "summary of… /
- 来源… / 风格…" meta line onto the canvas — that looks like a homework header. Such context
- belongs in your chat reply. (See the "Never echo the user's instructions" rule in `RULES.md`.)
- - **Render it, then look at the image and correct yourself**: fix text overflow, tight margins or
- padding, numerals touching edges, accidental overlaps, and clipping. Iterate render, view, fix
- until it is clean. (Commands and the full checklist are in `RULES.md`.) **When fixing, edit the
- `.svg` file in place with small targeted edits** (move a box, widen a panel, rewrap a label) —
- do not regenerate the whole SVG each pass; and batch the fixes you see in one view into a single
- edit pass before re-rendering, rather than one fix per render.
- - Write it into a Feishu doc as an editable whiteboard, then view the live board image too and fix
- any remaining layout issues.
- 5. **Deliver.** Give the user **both**: the **Feishu doc link** and the **rendered image** itself, so
- they can see it without opening the doc. Then tell them they can **switch to a different style**
- any time, and you will re render the same content in the new palette.
- ## Files
- - **[`RULES.md`](RULES.md)**: the hard rules and the exact build, write, and verify commands. Always read this.
- - **[`CATALOG.md`](CATALOG.md)**: every style with its vibe, formality, and what it is good for. Use it to choose.
- - **[`templates/<slug>/design.md`](templates/)**: one per style, the colour palette and how to use it.
- - **[`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)
- # Beautiful Feishu Whiteboard
- [中文 README](./README.zh.md)
- **A library of 35 curated colour palette styles for building gorgeous, *editable* Feishu / Lark
- (飞书) whiteboards.**
- See the [Feishu doc version of this intro](https://bytedance.us.larkoffice.com/docx/AldcdypvjoEqQDxcSVeu37ixs0d) (with usage-scenario showcases).
- This is an agent **skill** (for Claude Code and other agents that read `SKILL.md`). It is not an
- auto layout chart tool. Your agent composes the layout, and these templates give it a tasteful
- **colour palette and mood** plus the whiteboard medium's hard rendering rules. The result is a real,
- **editable** Feishu whiteboard inside a doc, not a screenshot.
- > Built from hard won, on board verified knowledge of what the Feishu SVG whiteboard renderer can and
- > cannot do (native shapes only, no opacity, the text colour export quirk, and more), all captured in
- > [`RULES.md`](RULES.md).
- ## Gallery
- Every style renders the **same content**, the three stages of LLM training, so you can compare
- palettes directly. The 35 styles are grouped from **restrained** to **bold**. Click a name to
- open its template.
- ### Restrained
- <table>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- </tr>
- </table>
- ### Balanced
- <table>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- </tr>
- </table>
- ### Bold
- <table>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- <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>
- </tr>
- <tr>
- <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>
- </tr>
- </table>
- ---
- ## Install
- **Tell your agent** (Claude Code, etc.):
- > "Install the **beautiful-feishu-whiteboard** skill from
- > `github.com/zarazhangrui/beautiful-feishu-whiteboard`."
- Or run the installer yourself:
- ```bash
- # 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):
- ```bash
- git clone https://github.com/zarazhangrui/beautiful-feishu-whiteboard \
- ~/.claude/skills/beautiful-feishu-whiteboard
- ```
- ## Requirements
- - **Node.js 20 or newer**
- - **A Feishu / Lark account.** Boards are written into your own tenant.
- - **`lark-cli`** (npm `@larksuite/cli`), installed and authenticated:
- ```bash
- npm install -g @larksuite/cli
- lark-cli config init # first run: scan the QR code
- lark-cli auth login # authorize your Feishu/Lark account
- ```
- - **`@larksuite/whiteboard-cli`**, used via `npx`, downloads automatically, no install needed.
- Run the bundled check any time: `bash scripts/preflight.sh`
- ## Use it
- Once installed, just ask your agent in plain language. You can name a style or describe a vibe:
- > - "Make a **Feishu whiteboard** explaining our onboarding flow, in the **Riso Brut** style."
- > - "Turn this doc into a visual **board** in Feishu, minimal **cobalt** look."
- > - "Draw the system architecture as a Feishu whiteboard, **playful candy** colours."
- > - "Explain the 3 LLM training stages as a board."
- Your agent will: ask what the board is for and what vibe you want, pick a fitting style from the
- [catalogue](CATALOG.md), compose the diagram with native shapes, render it and self correct
- (overflow, margins, overlaps), write it into a Feishu doc as an editable whiteboard, then send you
- **both the doc link and the image**. You can switch to a different style any time.
- ## How it works
- - **`SKILL.md`**: the agent entry point. When to use, the preflight, and the conversation flow
- (understand the board, ask the vibe, pick a style, build, deliver the link and image, offer to switch).
- - **`CATALOG.md`**: every style with its vibe, formality level, and what it is good for, so the agent
- can pick a style that fits the content.
- - **`RULES.md`**: the medium's hard limits (native shapes only, no opacity, no gradients or blur, the
- text colour export caveat) and the exact `lark-cli` and `whiteboard-cli` commands.
- - **`templates/<slug>/design.md`**: one per style, just the palette and how to use its colours. The
- agent is free to lay out the content however reads best; the template only constrains colour and mood.
- ## License
- [MIT](LICENSE) (c) Zara Zhang ([@zarazhangrui](https://github.com/zarazhangrui))
- Built on Feishu/Lark's `@larksuite/cli` and `@larksuite/whiteboard-cli`.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.