CtrlK
BlogDocsLog inGet started
Tessl Logo

lark-contact

飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名,以及按关键词搜索当前用户可见的机器人 / 智能体(agent)。当用户提到一个名字要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部门树遍历、按部门列员工、组织架构图,这类需求走原生 OpenAPI。

73

Quality

93%

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

93%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, token-efficient body: actionable bash examples, a decision table for command selection, an explicit candidate-confirmation checkpoint for side-effect flows, and clean one-level-deep references that all resolve to real files. The only modest gap is the absence of an explicit error-recovery feedback loop.

DimensionReasoningScore

Conciseness

Lean and efficient: a decision table plus short bash examples with no concept-padding (no explanation of what Feishu/open_id is); even the notes (41050, cross-tenant visibility, ID types) are Feishu-specific knowledge Claude does not already have, so every token earns its place.

5 / 5

Actionability

Fully executable, copy-paste-ready commands covering common cases — 'lark-cli contact +search-user --query "张三" --has-chatted --as user', the full 'user_profiles batch_query' invocation with --params/--data, and search-bot variants — not pseudocode.

5 / 5

Workflow Clarity

Clear sequence ('先搜,确认 open_id,再发') with an explicit validation checkpoint for side-effect operations ('搜索命中多条…把候选列给用户挑;不要擅自选第一条'), avoiding the batch/destructive cap of 3; falls short of 5 only because a full validate→fix→retry feedback loop is not spelled out.

4 / 5

Progressive Disclosure

Clear overview (identity×task decision table) with well-signaled one-level-deep references to the three real bundle files (lark-contact-search-user.md, -search-bot.md, -get-user.md) and clearly marked out-of-scope pointers to sibling skills; detail is appropriately split into the reference files.

5 / 5

Total

19

/

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 high-quality description: third-person voice, concrete actions, explicit use-when triggers, and clear scope boundaries that direct adjacent needs elsewhere. The only minor gap is a handful of natural user phrasings not enumerated in the trigger terms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — '按姓名 / 邮箱解析成 open_id', '按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名', '按关键词搜索…机器人 / 智能体' — giving comprehensive coverage of the skill's capabilities.

5 / 5

Completeness

Clearly answers 'what' (resolve name/email→open_id, reverse-lookup, bot search) and 'when' with concrete trigger phrases ('当用户提到一个名字要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用'), plus an explicit out-of-scope statement.

5 / 5

Trigger Term Quality

Good natural trigger coverage with synonyms ('姓名 / 邮箱', '机器人 / 智能体(agent)', '发消息 / 排日程') and an explicit '当用户提到一个名字…时使用' clause; a few natural phrasings a user might say (e.g. '查同事', '找人的 open_id') are not surfaced, keeping it just below 5.

4 / 5

Distinctiveness Conflict Risk

Clear Feishu/Lark-contact niche with distinct triggers and an explicit boundary ('不负责部门树遍历、按部门列员工、组织架构图…走原生 OpenAPI'), minimizing overlap with sibling skills.

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.

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