feishu-whiteboard-pro

Feishu Whiteboard Pro

Create real, editable Feishu SVG whiteboards with deliberate composition and verifiable content. The medium is intentionally narrow: one font, native rectangles/circles/connectors, no gradients, filters, opacity, or motion. Quality comes from truth, hierarchy, topology, rhythm, contrast, and air.

Core contract

• The brief wins. Honor supplied brand, palette, reference, density, and style commitments. A default or anti-pattern warning cannot silently redirect a clear request.
• Revision preserves; redesign replaces. A repair keeps content, relationships, geometry, and visual identity unless the user names an axis to change. A restyle changes the visual system, not the information architecture.
• Visual authority is evidence. An existing board, SVG, screenshot, or explicit brief remains authoritative even without a separate design document.
• Relationships are claims. Never invent an arrow, number, quotation, category, owner, status, or causal link to make the layout feel complete. Clearly label authored demonstration content.
• Mechanical checks and design judgment stay separate. Scripts own measurable defects; the reviewer owns truth, reading path, hierarchy, balance, density, contrast in context, and alignment.
• Verification is bounded. Inspect once, batch fixes, confirm once. Clear remaining deterministic failures, but do not reopen an unlimited taste loop.

Setup

Resolve <skill-dir> to the directory containing this SKILL.md; keep the working directory at the user's project. All bundled references and scripts resolve from <skill-dir>.

Run bash <skill-dir>/scripts/preflight.sh once before local rendering. Node 20+ is required. The whiteboard CLI runs through npx and may need network access on first use.

Feishu authentication is required only for publishing. Before writing a live board, run bash <skill-dir>/scripts/preflight.sh --publish. If publishing is unavailable, continue with the local SVG and tight PNG; do not discard a valid local deliverable.

Route the request

Read RULES.md for every build or edit, then load exactly one workflow:

Request	Workflow	Default authority
New board or replacement composition	references/create.md	User content, references, and the new board contract
Repair, restructure, restyle, or simplify an existing board	references/revise.md	Existing artifact plus the explicitly changed axes
Review, diagnose, or approve a board	references/critique.md	Current evidence; read-only unless fixes were requested

Load supporting references only when the selected workflow needs them:

• COMPOSITION.md for new structure or restructuring;
• CATALOG.md and one templates/<slug>/design.md for palette selection or restyling;
• CRITIQUE.md for design review and final delivery;
• templates/GENERATE.md only when no curated palette serves the brief.

If a request is ambiguous between creating and revising, inspect the supplied artifact first. Ask a question only when choosing the wrong authority would materially change the result.

Build and verify

For SVG work:

1. Start from the matching examples/*.svg when its topology fits. Replace content and recheck old arrowheads and meta text rather than trusting the example blindly.

2. Run the deterministic check:

   node <skill-dir>/scripts/fit-check.mjs <dir>/diagram.svg
   

3. Render and inspect the tight local image:

   npx -y @larksuite/whiteboard-cli@^0.2.11 \
     -i <dir>/diagram.svg -o <dir>/diagram.png -f svg
   

4. Batch visible fixes, rerun fit-check, and make one confirmation render. Use node <skill-dir>/scripts/fit-check.mjs --json <dir>/diagram.svg when passing evidence to another process.

5. For a material delivery, use the fresh read-only reviewer in agents/whiteboard-finish-reviewer.md. Pass the original request, fact/design contract, SVG, local PNG, checker output, and any real Feishu evidence.

Publish and deliver

Follow RULES.md for exact Feishu creation, update, and query commands. Publishing changes external state, so do it only when the user requested a live board or supplied a target to update.

Deliver the Feishu document link when publishing succeeded, plus the local diagram.svg and tight diagram.png. The square Feishu export is verification evidence, not the share image. If publishing is unavailable, deliver the local artifacts and the precise authentication step still required.

Repository files

• RULES.md — verified medium constraints and publish commands.
• references/ — create, revise, and critique playbooks; load one per request.
• COMPOSITION.md — spacing, type scale, archetypes, and anti-reflex guidance.
• CRITIQUE.md — truth gate, five visual axes, and bounded review flow.
• CATALOG.md — generated palette index.
• templates/ — curated palettes and the optional generation recipe.
• examples/ — editable gold-standard SVG starting points and renders.
• scripts/fit-check.mjs — deterministic medium and untransformed-geometry checker with text and JSON output.
• scripts/check-repo.mjs — offline repository regression check.
• scripts/preflight.sh — local and publish readiness check.