CtrlK
BlogDocsLog inGet started
Tessl Logo

dingtalk-contact

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

73

Quality

92%

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

92%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-structured skill body with explicit SOPs, guardrails, and clean one-level reference navigation. The only weakness is mild redundancy of the aisearch/search-mobile boundary across sections.

Suggestions

Consolidate the aisearch-vs-search-mobile boundary rule into one canonical statement and cross-reference it from the SOPs and 高频硬约束 instead of restating it verbatim in each section.

Break the long single-sentence preamble above the Shortcuts table into a short bullet list so the routing rules are scannable.

De-duplicate the Shortcuts table and the 意图表 where they list the same commands, or clearly note that one is auto-discovered and the other is hand-curated.

DimensionReasoningScore

Conciseness

Dense and directive with no concept-explanation padding, but the aisearch-vs-search-mobile boundary is restated across several sections and the shortcut preamble is a long single sentence that could be trimmed, fitting the efficient-with-minor-trim anchor.

4 / 5

Actionability

Copy-paste-ready commands throughout ("dws contact user get --ids <userId> --format json", "python scripts/contact_dept_members.py --query \"<部门名>\"") with specific examples covering the common cases, matching the fully-executable anchor.

5 / 5

Workflow Clarity

Five clearly sequenced SOPs with triggers, mandatory numbered steps ("切 aisearch(必须)", "解析(必须)"), explicit 禁止 guardrails, and a multi-命中 confirmation checkpoint; operations are read-only so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

Overview body points to well-signaled one-level-deep references (contact.md, 08-directory.md, intent-guide.md, lite-recipes.md, recipes/conventions.md) that all exist as real files, with content appropriately split and easy navigation.

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 tight, well-scoped description that states concrete capabilities, gives explicit Use-when triggers, and draws a clear boundary against the sibling dingtalk-aisearch skill. The only minor gap is synonym coverage in trigger terms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "查详情、部门、职位或邮箱", "按完整手机号反查用户", "查询自己、部门成员及角色", "补详情" — with comprehensive coverage of the contact-query domain, matching the anchor for multiple specific concrete actions.

5 / 5

Completeness

Explicitly answers both what ("钉钉通讯录精确查询") and when via a concrete "Use when ..." clause with specific trigger conditions, matching the anchor for clearly answering both with concrete triggers.

5 / 5

Trigger Term Quality

Strong natural trigger phrases users would say ("已有 userId 后查详情", "按完整手机号反查用户", "查询自己、部门成员及角色") but lacks some synonymous phrasings, landing above the midpoint between good and comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

Actively carves a distinct niche ("姓名模糊搜索、工号、职责、上下级走 dingtalk-aisearch,拿到 userId 后用本 skill") minimizing conflict with the sibling aisearch skill, matching the clear-niche anchor.

5 / 5

Total

19

/

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.

Validation13 / 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
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.