CtrlK
BlogDocsLog inGet started
Tessl Logo

lark-event

Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM messages/reactions/chat changes, Approval status changes, Task updates, VC meeting started/joined/ended, Minutes generated, Whiteboard updated, etc.). Use for Lark bots, real-time message processing, long-running subscribers, streaming webhook/push handlers. Supports `--max-events` / `--timeout` bounded runs and a stderr ready-marker contract — designed for AI agents running as subprocesses.

77

Quality

100%

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

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is lean, executable, and well-structured: concrete commands, a clear multi-step call flow with synchronization and error-recovery feedback loops, and a clean one-level-deep reference split that matches the actual bundle. No verbosity or generic concept padding.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no padding about what Lark/Feishu is or what a webhook is; every section (ready-marker contract, stdin-EOF behavior, kill -9 warning, jq schema decoding gotchas) is non-obvious domain-specific operational knowledge that earns its place. Not score 2 because there is no generic concept explanation that could be trimmed.

3 / 3

Actionability

Commands are concrete and copy-paste ready — `lark-cli event consume im.message.receive_v1 --max-events 1 --timeout 30s --as bot`, the multi-process `> receive.ndjson &` / `wait` example, and a real JSON schema snippet. Not score 2 because examples are fully executable rather than pseudocode with missing details.

3 / 3

Workflow Clarity

A numbered call flow (list → schema → consume) plus explicit checkpoints and feedback loops: the stderr ready-marker synchronization line, the exit-code/reason table, and error-envelope parsing ("Parse error.type/error.subtype to branch... error.hint for the recovery action"). Not capped at 2 because validation/error-recovery feedback is present for the streaming subscription operation.

3 / 3

Progressive Disclosure

The SKILL.md is an overview with a topic-index table pointing to seven verified one-level-deep reference files (application, approval, IM, task, VC, minutes, whiteboard), each clearly signaled with a link and coverage description; per-topic catalogs are appropriately split out. Scored against the actual bundle structure — all seven referenced paths exist in ./references/.

3 / 3

Total

12

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, comprehensive, and explicitly pairs capabilities with a 'Use for...' trigger clause in third-person voice. It names many concrete event categories and natural user terms, with low conflict risk against other skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions and event types — "stream events as NDJSON via lark-cli event consume", "IM messages/reactions/chat changes, Approval status changes, Task updates, VC meeting started/joined/ended, Minutes generated, Whiteboard updated". This exceeds the score-2 bar of naming a domain and some actions by being comprehensive across event categories.

3 / 3

Completeness

Both what (stream events as NDJSON via consume, covering listed event categories) and when are explicit — "Use for Lark bots, real-time message processing, long-running subscribers, streaming webhook/push handlers" is an explicit trigger clause, satisfying the rule that a missing 'Use when/Use for' clause caps completeness at 2.

3 / 3

Trigger Term Quality

Natural user-facing terms are well covered: "Lark/Feishu real-time event listening / subscribing / consuming", "Lark bots, real-time message processing, long-running subscribers, streaming webhook/push handlers". These are phrases a user would plausibly say, not just internal jargon, so it clears the score-2 'missing common variations' bar.

3 / 3

Distinctiveness Conflict Risk

Clear niche — Lark/Feishu real-time event consumption via a lark-cli subprocess contract with bounded runs and a stderr ready marker — with distinct triggers unlikely to fire for unrelated skills. Not score 2 because the niche and triggers are specific rather than merely 'somewhat specific'.

3 / 3

Total

12

/

12

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