# Edit Lark Whiteboards with AI

Teams need a reliable way to inspect and update Lark whiteboards without rebuilding diagrams manually. This skill guides Claude, Codex, and Claude Code through query, render, and update workflows.

## Install

```bash
npx skillstore add larksuite/lark-whiteboard
```

## Metadata

- Status: approved
- Slug: larksuite-lark-whiteboard
- Version: 1.0.0
- Author version: 1.0.0
- Skillstore revision: r1
- Version status: valid
- Tree hash: 9ab16513cfe470d6caf0b4f3ee9d282662be4d3cea3f79e99d10d35ad5cad546
- Author: larksuite
- GitHub username: larksuite
- License: MIT
- Repository: https://github.com/larksuite/cli/tree/main/skills/lark-whiteboard/
- Ref: 3e4b6c31a74a3bd1a291c98cf585d720cb9fbc88
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: scripts, filesystem, external\_commands, network
- Quality score: 69
- Public page: https://skillstore.pages.dev/skills/larksuite-lark-whiteboard
- Manifest: https://skillstore.pages.dev/api/skills/larksuite-lark-whiteboard/manifest

## Capabilities

- Query a Lark whiteboard and export preview images, SVG, code, or raw OpenAPI nodes.
- Update a whiteboard from Mermaid, PlantUML, SVG, or raw node input.
- Route diagram creation through Mermaid, SVG, or DSL workflows by diagram type.
- Generate local preview artifacts and render checks with @larksuite/whiteboard-cli.
- Guide image upload preparation for whiteboard media tokens.
- Provide scene guidance for architecture, org charts, funnels, pyramids, flywheels, and charts.

## Use Cases

- Review Existing Boards: Export a whiteboard as an image or SVG so reviewers can inspect current content.
- Create Architecture Diagrams: Turn system details into a structured architecture diagram and write it to a Lark whiteboard.
- Build Business Charts: Create funnels, pyramids, flywheels, or bar charts with preview rendering before publication.

## Prompt Templates

### Export a Preview

```
Use lark-whiteboard to export whiteboard <token> as a preview image. Save it to ./diagrams/review/preview.png.
```

### Update with Mermaid

```
Update whiteboard <token> with this Mermaid diagram. Render a preview first, then write it as the user after confirmation.
```

### Redesign an Existing Board

```
Query whiteboard <token>, inspect the preview, explain any SVG loss risk, then update the board with the requested visual changes.
```

### Create a Complex Diagram

```
Create a detailed architecture diagram for this system. Choose the correct route, render a PNG preview, fix issues, and update whiteboard <token>.
```

## Limitations

- Requires authenticated lark-cli access and whiteboard permissions.
- Cannot edit Lark document text, Sheets, or Base data.
- SVG round trips can lose semantic whiteboard structure.
- Complex layouts may require local file generation and preview rendering.

## Best Practices

- Confirm the whiteboard token and permission level before any update.
- Use preview rendering before writing complex diagrams.
- Keep generated artifacts in a dedicated dated directory.

## Anti Patterns

- Do not use overwrite until the user confirms the target board.
- Do not hand edit raw OpenAPI nodes for complex layouts.
- Do not treat SVG export as a lossless backup.

## Security Audit

- Audited at: 2026-07-09T09:19:52.312\+00:00
- Summary: Most static findings are false positives from markdown links, Mermaid examples, diagram terminology, and normal UTF-8 documentation. Confirmed risk is limited to npm and CLI execution plus an overwrite-capable remote whiteboard update workflow; no prompt injection or hidden payload evidence was found.

## Stats

- Views: 89
- Downloads: 16
- Favorites: 0
- Popularity score: 0