CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lark-whiteboard

飞书画板:查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责:飞书云文档内容编辑(lark-doc)、文档内嵌电子表格/Base(lark-sheets / lark-base)。

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A compact, dispatch-style overview: the body routes read/write intents through tight tables with concrete commands and a destructive-write confirmation, deferring detail to three real reference files. Main deductions are a dangling routes/svg-edit.md link, version-pinned commands inline, and no explicit post-write validation loop in the body itself.

Suggestions

Fix or create the referenced `routes/svg-edit.md` — the body's write-path table links to it but the file does not exist in the bundle.

Move the pinned version `@larksuite/whiteboard-cli@^0.2.13` into the reference file or a dedicated version/prerequisites note so the body stays version-agnostic.

Add an explicit post-update verification step (e.g., re-export a preview after `+update`) to close the feedback loop for destructive/batch write operations.

DimensionReasoningScore

Conciseness

The body is lean decision tables with essentially no padding — every row is actionable — but it embeds time-sensitive version info ("npx -y @larksuite/whiteboard-cli@^0.2.13") and a duplicated prerequisite pointer without a deprecated/versions section, so it sits just below the lean anchor.

4 / 5

Actionability

Gives concrete, executable guidance: exact commands (`lark-cli --version`, `+export --output-type preview/svg/source`), identity flags (`--as user`), and an explicit match-and-stop dispatch rule. Minor gap: full command syntaxes are deferred to reference files, so the body alone is not copy-paste ready.

4 / 5

Workflow Clarity

Clear two-stage decision procedure ("先判断「只读还是写入」,再在对应表内按上到下匹配,命中即停") with a destructive-operation checkpoint ("写入非空已有画板并需要 overwrite 时,先确认会整板重建"). Post-write verification/validation of results is not stated in the body, keeping it below the explicit-feedback-loop anchor.

4 / 5

Progressive Disclosure

Three real, well-signaled one-level-deep reference files (references/lark-whiteboard-export.md, -update.md, -workflow.md) are linked from both decision tables and a Shortcuts table, and details are properly split out. However, the body links to `routes/svg-edit.md` which does not exist in the bundle (no routes/ directory), a dangling navigation path.

4 / 5

Total

16

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-crafted description: concrete capability list, an explicit use-when clause with natural Chinese trigger phrases, and explicit boundary statements against sibling lark skills. Only weakness is that the update-format details (mermaid/plantuml/svg) and common diagram synonyms are not surfaced as trigger keywords.

DimensionReasoningScore

Specificity

Lists several concrete actions — "导出画板为预览图片", "导出原始节点结构", "使用多种格式更新画板内容" — but "多种格式" and "查询" stay generic, leaving minor gaps versus the comprehensive multi-action anchor.

4 / 5

Completeness

Explicitly answers both what ("支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容") and when ("当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill") with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Natural user phrases are present ("查看画板内容", "导出画板图片", "编辑画板") and would be said verbatim, but common synonyms like 流程图/架构图, 白板, or mermaid/plantuml/svg keywords are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

Clear niche (飞书画板 within 飞书云文档) plus explicit exclusions — "不负责:飞书云文档内容编辑(lark-doc)、文档内嵌电子表格/Base(lark-sheets / lark-base)" — minimizing conflict with sibling skills.

5 / 5

Total

18

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing, 5 suspicious

Warning

Total

12

/

16

Passed

Repository

larksuite/cli

Path

skills/lark-whiteboard/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.