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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |