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

Securityby

Passed

No findings from the security scan

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.

A well-structured, actionable body that routes by intent, surfaces destructive-operation guards and retry boundaries, and pushes deep flag detail to one-level-deep reference files. Minor conciseness redundancy and prose-form (rather than numbered) workflows keep it just short of top marks.

Dimension	Reasoning	Score
Conciseness	Lean and assumes Claude's competence (no 'what is Markdown' padding), but the 快速决策 routing bullets (lines 20-24) partly duplicate the shortcuts table and description verbs; not a 5 because of that minor redundancy that could be trimmed.	4 / 5
Actionability	Provides concrete commands (`lark-cli markdown +create/+diff/+fetch/+patch/+overwrite`), specific flags (--folder-token vs --wiki-token, --content/@file/-, --file-token), and a copy-paste-ready BAD/GOOD regex example covering the common escape gotcha; fully executable.	5 / 5
Workflow Clarity	Patch sequence is explicit (download → local replace → overwrite) with an empty-content validation guard and an error-classification feedback loop (stop on missing scope/permission denied/not found/quota vs limited retry on rate_limit/server_error); not a 5 because the sequence is prose rather than a numbered checklist with explicit re-validate loops.	4 / 5
Progressive Disclosure	Clear overview with a shortcuts table linking to five verified one-level-deep reference files (lark-markdown-create/diff/fetch/patch/overwrite.md) plus cross-skill links to lark-shared and lark-drive; content appropriately split and easy to navigate.	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 tight, well-scoped description that states concrete capabilities, an explicit trigger condition, and clear exclusions to avoid sibling-skill conflicts. The only gap is the missing `.md` extension as a natural trigger term.

Dimension	Reasoning	Score
Specificity	Lists five concrete actions — '查看、创建、上传、编辑和比较' (view, create, upload, edit, compare) — matching the comprehensive-coverage anchor; not a 4 because coverage is broad rather than having minor gaps.	5 / 5
Completeness	Explicitly answers both 'what' (查看/创建/上传/编辑/比较原生 Markdown 文件) and 'when' ('当用户要操作飞书 Markdown 文件...时使用') with concrete trigger phrases plus exclusion clauses; fits the top anchor exactly.	5 / 5
Trigger Term Quality	Good natural keywords ('飞书 Markdown', 'Markdown 文件', '比较', '远端版本', '本地草稿') with synonym coverage, but omits the `.md` file extension that users often say; not a 5 because that extension variant is missing.	4 / 5
Distinctiveness Conflict Risk	Niche is tightly scoped to Lark Drive native Markdown and explicitly excludes docx import, search, permissions, comments, move/delete — minimizing overlap with sibling skills; minimal conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

75%

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 — 12 / 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: 6 suspicious	Warning

	Total	12 / 16 Passed

Repository: larksuite/cli
Path: skills/lark-markdown/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.