CtrlK
BlogDocsLog inGet started
Tessl Logo

lark-openapi-explorer

飞书/Lark 原生 OpenAPI 探索:从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足,需要查找并调用原生飞书 OpenAPI 时使用。

68

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

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.

A lean, highly actionable skill body with a clear gated workflow and explicit safety/confirmation checkpoints for destructive API calls, plus clean one-level navigation to sibling skills. The only gap is the absence of an explicit error-recovery feedback loop after failed API calls.

DimensionReasoningScore

Conciseness

The body is largely efficient—concrete WebFetch prompts, CLI commands, and worked examples with little padding—though minor sections (the brand-entry table, the Chinese-translation blockquote) could be trimmed, matching the 'efficient with minor over-explanation' anchor.

4 / 5

Actionability

Provides fully executable, copy-paste-ready guidance: concrete WebFetch invocations with URLs and extraction questions, lark-cli api commands for every HTTP verb with params/data, and two complete worked scenarios with real commands, matching the fully-executable anchor.

5 / 5

Workflow Clarity

A clearly sequenced 5-step mining flow with an explicit Step 1 gate ("如果已有对应命令或 shortcut...不需要继续挖掘") and destructive-op validation (confirm intent, --dry-run) avoids the missing-validation cap; however no explicit error-recovery feedback loop is described, fitting the clear-sequence-with-minor-gaps anchor rather than a 5.

4 / 5

Progressive Disclosure

Well-organized into clear sections (文档库结构, 挖掘流程, 输出规范, 安全规则, 使用场景示例, 参考) with well-signaled one-level-deep references to sibling skills (../lark-shared/SKILL.md, ../lark-skill-maker/SKILL.md); no bundle files exist, so the self-contained overview is appropriately split and easy to navigate.

5 / 5

Total

18

/

20

Passed

Description

82%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 concise, third-person description that clearly states both its purpose and an explicit, well-scoped trigger condition, with minimal conflict risk against sibling lark skills. The only mild weakness is that the concrete action list is limited rather than comprehensive.

DimensionReasoningScore

Specificity

Names the domain ("飞书/Lark 原生 OpenAPI 探索") and 1-2 concrete actions ("从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口", "查找并调用原生飞书 OpenAPI"), but does not enumerate a comprehensive set of distinct actions, matching the anchor for domain + 1-2 concrete actions.

3 / 5

Completeness

Clearly answers both what ("从官方文档库中挖掘...原生 OpenAPI 接口") and when with a concrete trigger phrase ("当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足...时使用"), matching the anchor for explicit what + when with concrete triggers.

5 / 5

Trigger Term Quality

Good keyword coverage with natural trigger terms ("飞书/Lark OpenAPI", "lark-* skill", "lark-cli", and the explicit "当...时使用" trigger), though framed as a negative condition (when existing tools fail) rather than a broad set of positive synonyms, leaving a few natural terms missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche (native OpenAPI not wrapped by CLI) with an explicit deferral trigger that only activates when existing lark-* skills and lark-cli commands cannot satisfy the request, minimizing conflict risk with sibling skills.

5 / 5

Total

17

/

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.

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