CtrlK
BlogDocsLog inGet started
Tessl Logo

lark-skill-maker

创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill(包装原子 API 或编排多步流程)时使用。

68

Quality

86%

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

87%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is concise, highly actionable, and well-structured with appropriate one-level external references. Its main gap is the absence of an explicit validation/feedback loop for verifying a generated Skill or guarding destructive writes.

Suggestions

Add an explicit verification step for produced Skills (e.g. run a dry-run or smoke-test command against a sandbox tenant before delivery) with a fix→retry loop.

Expand the destructive-write guidance from a one-line suggestion into a concrete validate-then-confirm checkpoint in the workflow.

Note that no references/ or scripts/ bundle exists; if detailed scope tables or templates grow, move them into reference files to preserve the lean overview.

DimensionReasoningScore

Conciseness

Lean and efficient throughout — concrete CLI commands, a compact template, and terse principle bullets with no padding or re-explanation of concepts Claude already knows.

3 / 3

Actionability

Provides fully executable lark-cli commands with real flags (--params, --data), real API paths, and a copy-paste-ready SKILL.md template with concrete examples.

3 / 3

Workflow Clarity

Sequences the research flow (numbered 1-3) with a fallback escalation and template Step 1/Step 2 data passing, but lacks an explicit validate→fix→retry checkpoint for the produced Skill or destructive writes, which the rubric caps at 2.

2 / 3

Progressive Disclosure

Well-organized into clear sections with one-level-deep, clearly signaled external references (../lark-openapi-explorer, ../lark-shared) and no nested references; appropriate for a compact skill with no bundle directory.

3 / 3

Total

11

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, complete, and distinct, clearly stating both capabilities and an explicit use-when trigger. Its only weakness is that the trigger phrasing is somewhat technical and could include more natural user-facing keyword variations.

Suggestions

Add more natural, user-spoken trigger keywords (e.g. "封装飞书 API", "把飞书操作做成 Skill", "编排飞书多步流程") alongside the technical phrasing.

Consider naming the target audience or examples of typical inputs a user would describe to broaden trigger coverage.

DimensionReasoningScore

Specificity

Names concrete actions — "把飞书 API 操作封装成可复用的 Skill" with two distinct modes "包装原子 API" and "编排多步流程", matching the 'lists multiple specific concrete actions' anchor rather than the partial level 2.

3 / 3

Completeness

Explicitly states what the skill does (创建 lark-cli 的自定义 Skill) and when to use it via an explicit "当用户需要...时使用" clause, satisfying both what and when.

3 / 3

Trigger Term Quality

Includes a trigger clause and relevant terms ("封装成可复用的 Skill", "编排多步流程") but leans technical and misses the common natural variations a user would say, fitting the 'some relevant keywords but missing common variations' anchor.

2 / 3

Distinctiveness Conflict Risk

Scoped to authoring custom lark-cli Skills, a clear niche with distinct triggers unlikely to fire for unrelated skills.

3 / 3

Total

11

/

12

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.

Validation12 / 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: 2 suspicious

Warning

Total

12

/

16

Passed

Repository
larksuite/cli
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.