Content
78%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, navigable CLI skill reference with strong progressive disclosure and concrete commands. Main weakness is that executable workflows and validation feedback loops are delegated to referenced files rather than surfaced inline for the most common operations.
Suggestions
Inline one or two copy-paste-ready command examples for the most common operations (e.g. send a text message, list chat members) so Claude can act without opening a reference file.
Surface the key validation feedback loop (e.g. inspect per-item results and retry failures for batch join_request.handle / feed-shortcut operations) directly in the body rather than only in referenced files.
Tighten the AppLink and identity-mapping prose into terse bullets to trim tokens where Claude can infer the rest.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense but mostly token-efficient: bullet points, tables, and identifier conventions with little padding, though a few notes (e.g. AppLink/identity mapping prose) could be tightened slightly to fully assume Claude's competence. | 4 / 5 |
Actionability | It gives concrete executable commands (lark-cli schema im.<resource>.<method>, lark-cli im +<verb>), a full shortcuts table with flags, and a permission table, but largely describes and links out rather than providing copy-paste-ready command sequences for common cases inline. | 4 / 5 |
Workflow Clarity | Multi-step risky flows are well sequenced — the card-create workflow is mandatory with explicit must-read references, and batch operations note that exit 0 does not imply per-item success — but the validation feedback loops themselves live in the referenced files rather than inline in the body. | 4 / 5 |
Progressive Disclosure | The body is a clear overview that points one level deep to real references/*.md and references/card/* files, all of which exist, signaled cleanly via the shortcuts table and [Must-read] markers, making navigation easy. | 5 / 5 |
Total | 17 / 20 Passed |