CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dingtalk-contact

钉钉通讯录精确查询。Use when 已有 userId 后查详情、部门、职位或邮箱,按完整手机号反查用户,或查询自己、部门成员及角色。姓名模糊搜索、工号、职责、上下级走 dingtalk-aisearch,拿到 userId 后用本 skill 补详情。命令前缀:dws contact。

Quality

88%

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

88%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 highly actionable, well-guarded operational skill: concrete commands throughout, explicit validation and confirmation checkpoints for risky writes, and proper offloading of the 41KB command reference to bundle files. The only notable weaknesses are redundancy between SOP-1/SOP-2 and between SOP-5 and the hard-constraints section, and some overlap between the inline SOPs and lite-recipes.md.

DimensionReasoningScore

Conciseness

Almost entirely dense operational contracts with no teaching of concepts Claude already knows, but SOP-2 substantially repeats SOP-1 and the friend openDingTalkId sourcing rules appear near-verbatim in both SOP-5 and the 高频硬约束 section, so some trimming is possible.

4 / 5

Actionability

Every step is a copy-paste-ready command with exact flags and --format json, plus concrete edge-case handling (sentinel deptId=-1 normalized to deptId=1, status codes translated 1=待接受、3=已成为好友), fully covering the common cases.

5 / 5

Workflow Clarity

Five numbered SOPs with explicit sequencing, 禁止 rules, multi-hit disambiguation checkpoints that require user confirmation, mandatory explicit confirmation before the irreversible +friend-remove write, and defined error-recovery paths for unknown flag/command cases.

5 / 5

Progressive Disclosure

Bulk material is properly externalized one level deep and clearly signaled (references/contact.md, references/08-directory.md, references/intent-guide.md, references/lite-recipes.md — all verified to exist), but the inline SOP section is long and overlaps content in lite-recipes.md, leaving minor organization gaps.

4 / 5

Total

18

/

20

Passed

Description

87%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, tight description with explicit what/when triggers and excellent boundary routing against the sibling aisearch skill. The main gap is that friend-management capabilities (list, requests, add/remove) — a substantial part of the skill body — are not represented at all, slightly capping specificity and trigger-term coverage.

Suggestions

Add a brief clause covering friend operations (e.g., 好友列表、好友申请、加/删好友) since SOP-5 and six +friend-* shortcuts are a major capability of this skill.

Include one or two natural friend-related trigger phrases (好友、加好友) so users asking about friends route to this skill instead of elsewhere.

DimensionReasoningScore

Specificity

Lists several concrete actions ("已有 userId 后查详情、部门、职位或邮箱", "按完整手机号反查用户", "查询自己、部门成员及角色"), but the friend-relationship capabilities that occupy a full SOP and six shortcuts in the body are entirely absent, which is more than a minor coverage gap.

4 / 5

Completeness

Explicitly answers both what ("钉钉通讯录精确查询" with enumerated lookup actions) and when ("Use when 已有 userId 后查详情…按完整手机号反查用户,或查询自己、部门成员及角色") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural terms users would say are well covered (userId、部门、职位、邮箱、手机号反查、部门成员、角色、工号、上下级), but friend-related phrasings (好友/加好友/好友申请) that the skill actually handles are missing along with a few common synonyms.

4 / 5

Distinctiveness Conflict Risk

Explicitly delimits itself from dingtalk-aisearch ("姓名模糊搜索、工号、职责、上下级走 dingtalk-aisearch,拿到 userId 后用本 skill 补详情") and names its command prefix, giving it a clear niche with minimal conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 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

relative_links

Relative link issues: 1 suspicious

Warning

Total

13

/

16

Passed

Repository

DingTalk-Real-AI/dingtalk-workspace-cli

Path

skills/multi/dingtalk-contact/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.