CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lark-slides

飞书幻灯片:创建和编辑幻灯片。创建演示文稿、读取幻灯片内容、管理幻灯片页面(创建、删除、读取、局部替换)。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。当用户给出 doubao.com 的 /slides/ URL/token 时,也应直接使用本 skill,不要因为域名不是飞书而回退到 WebFetch;路由依据是 URL 路径模式和 token,而不是域名。不负责:云文档内容编辑(走 lark-doc)、云文档里的独立画板对象(走 lark-whiteboard)、上传或下载普通文件(走 lark-drive)。

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

An exceptionally actionable, well-validated skill body: exact commands, syntax-level XML gotchas, and a workflow with explicit lint/read-back gates and error-recovery loops. Its weaknesses are minor — repeated replace/update routing guidance and one unverifiable cross-skill reference.

Suggestions

Consolidate the +replace-slide vs +update-slide guidance (currently stated in the Quick Reference table, the editing paragraph, the Shortcuts table, and 核心规则 7) into a single authoritative location to reduce token cost.

Fix or verify the ../lark-shared/SKILL.md reference marked CRITICAL at the top of the body — it does not resolve within this bundle.

Consider moving the ~65-line 豆包设计原则 section into its own reference file (linked alongside visual-planning.md) to keep SKILL.md a lean routing hub.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational knowledge (e.g., '文字颜色必须用 color 属性而不是 fontColor', 'lineSpacing="multiple:xx"', '图片必须用 <img> 而不是 <image>', rgba gradient format with stop percentages) and explains nothing Claude already knows. However, the +replace-slide vs +update-slide routing guidance is repeated ~4 times (Quick Reference table, editing paragraph, Shortcuts table, 核心规则 7) and the read-planning-docs mandate appears in three CRITICAL blocks plus 执行前必做 plus Step 1 — minor trimming opportunities, matching anchor 4 rather than 3 since the repetition is deliberate emphasis on error-prone decisions, not padding.

4 / 5

Actionability

Everything is executable: copy-paste commands ('lark-cli wiki +node-get --node-token ... --as user --format json', 'lark-cli auth login --domain slides'), exact attribute syntax with a full gradient example, exact paths (.lark-slides/plan/<deck-or-task-id>/slide_plan.json), a machine-checkable lint gate ('summary.error_count 必须为 0'), and numeric limits (960x540, 20 MB, 10 pages per screenshot batch, 40px margins) covering all common cases.

5 / 5

Workflow Clarity

The four-step 生成流程 has explicit validation gates: mandatory xml_lint.py before submission, post-create read-back via slides +xml-get, verification per workflow/validation-xml.md, and an error-recovery feedback loop per workflow/error-handling.md ('失败或部分成功按 workflow/error-handling.md 处理;局部问题优先用 +replace-slide 修正'). Destructive deletes require read-back confirmation first, satisfying the feedback-loop requirement for destructive/batch operations — matching the top anchor.

5 / 5

Progressive Disclosure

The body acts as a hub with well-signaled, one-level-deep references (references/cli/*, references/workflow/*, references/xml/*, references/planning-layer.md), and all ~20 referenced paths were verified to exist; heavy assets (254 KB XML schema, 747 KB icon index) are correctly kept out of SKILL.md. Two minor gaps keep it below the top anchor: the CRITICAL-mandatory reference ../lark-shared/SKILL.md does not exist in the bundle (unverifiable/missing), and the ~65-line inline 豆包设计原则 design guidance could arguably live in a reference file like the other planning layers.

4 / 5

Total

18

/

20

Passed

Description

92%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 highly specific, complete description with explicit what/when clauses, concrete trigger phrases, and unusually good boundary fencing against sibling skills. The only gap is missing the very common "PPT"/.pptx synonyms in the trigger terms.

DimensionReasoningScore

Specificity

Enumerates multiple concrete actions — "创建演示文稿、读取幻灯片内容、管理幻灯片页面(创建、删除、读取、局部替换)" — plus explicit routing and exclusion rules, giving comprehensive coverage of the skill's operations with no gaps, matching the top anchor rather than the 'minor gaps' of 4.

5 / 5

Completeness

Both questions are explicitly answered: the what ("创建和编辑幻灯片。创建演示文稿、读取幻灯片内容、管理幻灯片页面") and the when ("当用户需要创建或编辑幻灯片、读取或修改单个页面时使用"), plus an additional concrete trigger (doubao.com /slides/ URL/token). This matches the top anchor of explicit what AND when with concrete trigger phrases; score 4 would require the when to be less explicit.

5 / 5

Trigger Term Quality

Natural terms like 幻灯片、演示文稿、创建/编辑/读取/修改单个页面 and the /slides/ URL/token trigger are present, but common synonyms users actually say — "PPT" and ".pptx" (used throughout the skill body) — are missing from the description, matching 'good keyword coverage; a few natural terms missing' rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description explicitly fences sibling skills — "不负责:云文档内容编辑(走 lark-doc)、…画板对象(走 lark-whiteboard)、上传或下载普通文件(走 lark-drive)" — and adds a domain-based routing rule, giving a clear niche with minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

68%

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

Validation — 11 / 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: 36 deeper-than-1-level, 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 37 deeper-than-1-level

Warning

Total

11

/

16

Passed

Repository

larksuite/cli

Path

skills/lark-slides/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.