lark-slides

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

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

85%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 highly actionable, well-structured skill body with strong validation feedback loops and clean progressive disclosure. Its main weakness is redundancy: several hard rules are restated verbatim across multiple sections.

Suggestions

Consolidate the repeated XML/element hard rules (chart-vs-shape, <img> not <image>, table construction) into a single authoritative section and cross-reference it from 权威经验 and 核心规则 instead of restating them.

Move the dense per-shortcut parameter detail already living in references/cli/*.md out of the Shortcuts/Quick Reference tables to reduce repeated inline expansion.

Dimension	Reasoning	Score
Conciseness	Tone is lean and assumes Claude's competence (no basic-concept explanation), but the same hard constraints (chart vs shape, <img> not <image>, table rules) are repeated across 权威经验, 核心规则, and the Quick Reference table, adding tokens that could be consolidated.	3 / 5
Actionability	Provides concrete executable commands (lark-cli slides +create/+add-slide/+delete-slide, auth login, wiki +node-get), ready XML snippets (gradient rgba format, <content> usage), and a need-to-command table covering common cases.	5 / 5
Workflow Clarity	The 生成流程 (Steps 1–4) is clearly sequenced with explicit validation checkpoints (xml_lint.py error_count==0, +xml-get readback, validation-xml.md) and feedback loops for error recovery on destructive/XML operations.	5 / 5
Progressive Disclosure	SKILL.md is a well-signaled overview pointing to a rich one-level-deep bundle (references/cli/, references/workflow/, references/xml/, scripts/) via the Quick Reference table, 执行前必做 list, and Shortcuts table; referenced paths correspond to real bundle files.	5 / 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 strong, specific description that states capabilities, trigger conditions, and boundaries in third person. Minor room to add the everyday term "PPT" and a file extension to broaden trigger-term coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "创建演示文稿、读取幻灯片内容、管理幻灯片页面（创建、删除、读取、局部替换）" — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both what (创建/读取/管理页面) and when ("当用户需要创建或编辑幻灯片...时使用"; "当用户给出 doubao.com 的 /slides/ URL/token 时") with concrete trigger phrases plus explicit non-responsibilities.	5 / 5
Trigger Term Quality	Good natural keyword coverage with synonyms (幻灯片/演示文稿/页面) and concrete URL/token triggers ("/slides/ URL/token", "doubao.com"), though the common term "PPT" and a file extension are not surfaced in the description itself.	4 / 5
Distinctiveness Conflict Risk	Clear niche (飞书幻灯片) with explicit exclusions routing to lark-doc, lark-whiteboard, and lark-drive, minimizing overlap and wrong-skill triggering.	5 / 5
	Total	19 / 20 Passed

Validation

68%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: ceace6d

Reviewed: 2 hours ago

Table of Contents

Discovery Implementation Validation

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.