CtrlK
BlogDocsLog inGet started
Tessl Logo

dingtalk-event

钉钉个人 IM、OA 审批、VoIP 通话邀请、待办与互动卡片回调事件长连接监听。Use when 用户说监听消息/@我/某人/某群/全部消息、已读/撤回/reaction、群成员加入/群成员退出/群状态变化,监听审批任务创建/完成/转交、审批实例发起/抄送/终止/完成、VoIP 通话邀请、待办创建/更新/删除,或互动卡片回调。命令前缀:dws event。

72

Quality

91%

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.

Excellent content quality: an overview-sized SKILL.md with fully executable commands, explicit validation gates (ready marker, unique-resolution stop, dry-run confirmation), and a well-signaled one-level-deep reference bundle with per-file load conditions. The only improvement area is trimming operational contract detail duplicated between the body and the references.

DimensionReasoningScore

Conciseness

The body is dense and command-centric with tables carrying most of the load and no explanations of concepts Claude already knows. However, operational detail such as the 本地订阅保护 file paths/permissions and the full 0/2/1 retry-budget sentence restates contract text that also lives in references/event-im-operations.md and references/event-im.md, so minor trimming is possible. It is efficient with a few over-detailed passages rather than fully lean.

4 / 5

Actionability

Guidance is fully executable throughout: exact commands with flags (dws event +listen-im --kind sender --user-query <姓名>, dws event stop <subscribe_id> --dry-run), mutually-exclusive parameter rules (--user/--open-dingtalk-id/--user-query 之一), exact output field paths (payload.body.actionData.context, answers[question_id]), and concrete ready-gate formats. Specific examples cover the common cases copy-paste ready.

5 / 5

Workflow Clarity

The sequence is explicit with validation checkpoints and error-recovery loops: unique name resolution that stops on zero/multi match before creating subscriptions, the mandatory ready marker ('必须等待 ready,不用 sleep 猜测'), dry-run then --yes confirmation for stop, rollback on partial subscription failure, and retry/cooldown/terminal_hold handling. This matches the anchor with explicit validation steps and feedback loops.

5 / 5

Progressive Disclosure

The body is an overview with a Golden Route table and a Reference table giving per-file 何时读取 (when-to-read) conditions; all 9 referenced files exist and are substantive, references are one level deep, and event-im.md acts as a routing index rather than nested content. Navigation is well signaled and content is appropriately split, matching the top anchor.

5 / 5

Total

19

/

20

Passed

Description

91%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 description: concrete capability statement, explicit and comprehensive 'Use when' trigger phrases with synonyms, and a command prefix for disambiguation. The only weaknesses are minor — a couple of unqualified triggers and no boundary statement against sibling DingTalk skills.

DimensionReasoningScore

Specificity

The description names the concrete action (长连接监听 long-connection listening) and enumerates five specific event domains — personal IM, OA approval, VoIP call invitations, todo, and interactive card callbacks — with per-category event types (已读/撤回/reaction, 审批任务创建/完成/转交, 待办创建/更新/删除). It lists several specific capabilities with only minor gaps (a single action verb, no statement of output/delivery), placing it above the '1-2 concrete actions' anchor but short of fully comprehensive multi-action coverage.

4 / 5

Completeness

It explicitly answers both 'what' (钉钉个人 IM、OA 审批、VoIP 通话邀请、待办与互动卡片回调事件长连接监听) and 'when' (Use when 用户说… followed by concrete trigger phrases), plus the command prefix (dws event). This matches the anchor of clearly and explicitly answering both what and when with concrete trigger phrases; the 'when' clause cannot be made more explicit.

5 / 5

Trigger Term Quality

The 'Use when 用户说…' clause gives comprehensive natural trigger phrasings with synonyms and variations: 监听消息/@我/某人/某群/全部消息、已读/撤回/reaction、群成员加入/群成员退出/群状态变化、VoIP 通话邀请、互动卡片回调, covering how users would actually phrase requests. Coverage matches the synonym-inclusive anchor; no common natural term is missing.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche (DingTalk real-time personal event listening) and most triggers carry the 监听 qualifier, but 'VoIP 通话邀请' and '互动卡片回调' are unqualified and the description does not delineate against sibling skills that operate on approvals/todos. Mostly distinct with minor overlap risk against closely related skills; not the minimal-conflict top anchor.

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