CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lark-markdown

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

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

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

Well-structured, token-efficient routing skill: concrete commands, sharp routing and boundary rules, real one-level-deep references, and explicit error-recovery guidance. The small deductions are for slight redundancy around +patch semantics and the absence of an explicit post-write verification checkpoint.

DimensionReasoningScore

Conciseness

The body is tight and assumes competence — decision rules, flag semantics, and an executable regex-escaping example with no concept explanations. Minor trimming is possible: the '+patch' internal semantics are explained twice ("先完整下载 Markdown,再本地替换,再整文件覆盖上传" followed by "不是服务端原子 patch;它是 CLI 侧编排出来的局部更新能力") and the empty-file rule carries a justification ("因为 Drive 不支持零字节 Markdown,且空文件通常是误操作") that could be dropped. Fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the fully lean anchor 5.

4 / 5

Actionability

Every decision line maps to a concrete command with correct flags ("lark-cli markdown +create --folder-token" vs "--wiki-token", URL normalization), and the regex example is copy-paste ready with BAD/GOOD variants. 'Fully executable; copy-paste ready commands; specific examples cover the common cases' matches anchor 5; there are no pseudocode or missing key details.

5 / 5

Workflow Clarity

The flow is well sequenced — read lark-shared first (MUST), choose identity with auth step, route to a shortcut, and explicit error-triage checkpoints distinguishing stop conditions ("missing scope... 默认停止重试并按报错 hint 处理") from retryable ones ("只有 rate_limit、server_error... 才做有限退避重试"). It falls short of anchor 5 because there is no post-write verification step (e.g., fetch/diff to confirm the result) and patch/overwrite validation detail is deferred to references rather than stated as a checkpoint here.

4 / 5

Progressive Disclosure

The body is a clean overview: a shortcut table links each verb to a real one-level-deep reference file (all five references/lark-markdown-*.md files exist and match their descriptions), and cross-skill links to lark-shared and lark-drive are clearly signaled in a dedicated 参考 section. 'Clear overview with well-signaled one-level-deep references; easy navigation' matches anchor 5.

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 description: it names concrete capabilities, gives explicit use-when triggers with concrete phrases, and draws sharp boundaries against adjacent skills. The only gap is missing '.md' extension and a few synonym trigger terms, which keeps trigger-term quality just below the top anchor.

DimensionReasoningScore

Specificity

The description lists five concrete actions ("查看、创建、上传、编辑和比较" — view, create, upload, edit, compare) on native Markdown files in Feishu, comprehensively covering the skill's full shortcut surface. This matches the 'multiple specific concrete actions; comprehensive coverage' anchor; score 4 would require noticeable coverage gaps that are absent.

5 / 5

Completeness

It explicitly answers 'what' ("查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件") and 'when' ("当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用"), plus explicit non-triggers ("纯本地 Markdown 文件操作不触发本 skill"). This clearly matches anchor 5; anchor 4 would leave the 'when' clause less explicit.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ("飞书 Markdown", "Markdown 文件", "比较其远端版本及本地草稿") and would be said by users, but the description omits file-extension terms like "`.md`" and common synonyms such as "md 文件" or "版本对比/diff". Good keyword coverage with a few natural terms missing fits anchor 4; anchor 5 requires extension and synonym coverage that is not there.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (native `.md` files in Feishu Drive) and explicitly disclaims overlapping scopes ("不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作"), minimizing conflict with sibling skills. Clear niche with distinct triggers fits anchor 5.

5 / 5

Total

19

/

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: 6 suspicious

Warning

Total

12

/

16

Passed

Repository

larksuite/cli

Path

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