agentleFS
zarazhangruizarazhangrui/beautiful-feishu-whiteboard/SKILL.md

beautiful-feishu-whiteboard

Skill701 starsChanged 5 months agoMITView on GitHub

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.

  • Installs packages

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 1

    1. Aquarius-mu/skillManager★ 187% same

    Wrote their own version · 0

    None found.

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 2 are distinctive, and 5 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run scripts/preflight.sh, or check manually:

    line 33
  2. Very specific:

    If lark-cli is missing or not authenticated, tell the user exactly how to install and authenticate, then stop.

    line 41
  3. Distinctive:

    Ask about the vibe: Ask the user what visual style they want, for example playful or professional, any colour or mood preference, or a …

    line 48
  4. Very specific:

    Pick a style: Use CATALOG.md to match the content type and the requested vibe and formality to one of the 35 styles.

    line 51
  5. Very specific:

    Build it: Read RULES.md and only the one chosen templates/<slug>/design.md, then:

    line 55
  6. Distinctive:

    Write it into a Feishu doc as an editable whiteboard, then view the live board image too and fix any remaining layout issues.

    line 70
  7. Very specific:

    [CATALOG.md](CATALOG.md): every style with its vibe, formality, and what it is good for.

    line 79

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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 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, 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 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 and only the one chosen templates/<slug>/design.md, 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: the hard rules and the exact build, write, and verify commands. Always read this.
  • CATALOG.md: every style with its vibe, formality, and what it is good for. Use it to choose.
  • templates/<slug>/design.md: one per style, the colour palette and how to use it.
  • scripts/preflight.sh: dependency and auth check.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.