CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lark-approval

飞书审批:查询和处理审批待办/已办/实例,搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务;非审批类待办走 lark-task。不负责创建审批定义;三方审批定义不走原生提单。

Quality

87%

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

81%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-engineered operational skill body: executable commands, explicit routing arbitration, minimal-first-information principles, and a real error-recovery decision tree. The main costs are redundant restatements of the routing and retry rules, and the initiate flow's two critical parameter references being buried one level below the top-level table.

Suggestions

State the routing rule (审批待办不是飞书任务 + the action-verb list) once instead of twice in the 路由优先级 section; the 判定规则 paragraph largely repeats the preceding bullet list.

Surface lark-approval-instance-form-control-parameters.md and lark-approval-instance-value-sourcing.md in the SKILL.md table (e.g., on the instances create row) so the create flow's mandatory references are visible at the top level.

Merge the duplicate retry guidance: 执行原则 §3 and the 1395001 section both say '最多重试1次' — keep the number in one place and cross-reference it.

DimensionReasoningScore

Conciseness

The body is a dense routing table plus decision rules with essentially no padding or explanation of known concepts. It falls short of 5 because there is noticeable duplication: "审批待办不是飞书任务" is stated twice (routing header and 判定规则), the action list 同意/拒绝/转交/退回/撤回/催办/加签/抄送 is enumerated twice within the same routing section, and "最多重试1次" is repeated between 执行原则 §3 and the 1395001 section.

4 / 5

Actionability

Highly concrete: a 14-row command mapping table, a bash block with real CLI invocations, topic enum codes (1待办 2已办 17未读 18已读), and the exact 1395001 error-code decision tree. It is not 5 because the flagship complex operation — instances create — shows "form":"[...]" in the example, which is a placeholder rather than usable syntax and delegates the hard part entirely to the reference; minor gaps remain for a first-time reader.

4 / 5

Workflow Clarity

Both processing chains are explicitly sequenced (发起审批: search → get → create; 处理审批: query → optional get → operate) with the precondition rule that operations must carry instance_code + task_id as a pair. Error recovery is a genuine feedback loop: the 1395001 decision tree stops blind retries, permits exactly one re-query, and ends with a required user-facing conclusion — matching the 5 anchor's 'explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

The body is a clean overview: a per-command table where every row links a verified reference file, with all 14 linked files present in references/. It is not 5 because two reference files that the body itself calls critical for the create workflow (lark-approval-instance-form-control-parameters.md, lark-approval-instance-value-sourcing.md) are not surfaced anywhere in SKILL.md — they are only discoverable via a second hop through initiate.md, and references cross-link each other, so navigation is two hops deep for the most complex flow.

4 / 5

Total

17

/

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: concrete capabilities, an explicit 'use when' clause, and unusually good boundary routing against the sibling lark-task skill. The only weakness is that approve/reject/transfer/remind-style natural verbs users say are subsumed under the generic '处理' rather than listed as triggers.

Suggestions

Include the most common natural action verbs users say — 同意/拒绝/转交/催办 (approve, reject, transfer, remind) — in the 'use when' clause, e.g. '当用户要同意、拒绝、转交或催办审批时使用'.

Add one or two concrete approval types users mention by name (请假审批, 报销审批) as trigger terms to broaden natural-phrase matching.

DimensionReasoningScore

Specificity

The description lists multiple concrete, comprehensive actions within the Feishu approval domain: "查询和处理审批待办/已办/实例", "搜索可发起审批定义", "查看定义详情", "发起原生审批实例" — matching the anchor of multiple specific concrete actions with comprehensive coverage. It is not the level below (4) because there are no meaningful coverage gaps in the domain's core verbs; every major capability (query, process, search, view, create) is named.

5 / 5

Completeness

Explicitly answers both questions: 'what' via the concrete action list, and 'when' via the explicit trigger clause "当用户要处理审批任务、查看审批实例、搜索或发起审批时使用", plus explicit boundary statements ("不负责创建审批定义;三方审批定义不走原生提单"). This mirrors the 5-anchor example with concrete trigger phrases; the 'when' clause is explicit, not merely present as at level 4.

5 / 5

Trigger Term Quality

Good keyword coverage of natural user phrasings: "审批待办", "审批实例", "搜索或发起审批", "处理审批任务". It is not 5 because common natural verbs users say in this workflow — 同意/拒绝 (approve/reject), 转交, 催办, 请假/报销 approval nouns — are folded under generic "处理" rather than appearing as explicit trigger terms; it is above 3 because the terms present are exactly what users would naturally say, not jargon.

4 / 5

Distinctiveness Conflict Risk

It has a clear niche (Feishu approval instances) and actively de-conflicts against the nearest competing skill: "审批待办不是飞书任务;非审批类待办走 lark-task" — routing instructions that prevent wrong-skill triggering. Minimal conflict risk with any other skill, matching the 5 anchor's 'clear niche with distinct triggers'.

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

Warning

Total

12

/

16

Passed

Repository

larksuite/cli

Path

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