Content
92%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, highly actionable skill body that routes user intents to concrete CLI commands with explicit validation and safety checkpoints for destructive operations, and pushes per-shortcut detail into one-level-deep reference files. Its only weakness is mild repetition of the identity-resolution pattern that could be consolidated.
Suggestions
Consolidate the repeated URL→space_id / node-token resolution pattern (described separately for member ops, node-list, and delete-space) into a single canonical snippet referenced from each flow to tighten conciseness.
Factor the identity-selection guidance ('--as user' default, bot+department hard limit) into one place and reference it, rather than restating the bot/department constraint in both the callout and the quick-decision list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and operational with no concept over-explanation, but the URL→space_id identity-resolution pattern is repeated across several quick-decision bullets and the delete-space flow, which could be factored out; fits the 'efficient, minor trim opportunities' anchor rather than a fully lean 5. | 4 / 5 |
Actionability | Provides copy-paste-ready commands throughout (e.g. 'lark-cli wiki +node-get --node-token <wiki_url> --as user --format json', 'lark-cli wiki +delete-space --space-id <ID> --yes', full contact API calls with params JSON) and concrete examples covering the common member-add cases for user/group/app/department. | 5 / 5 |
Workflow Clarity | Destructive and batch flows are explicitly sequenced with validation checkpoints — the delete-space flow requires resolving space_id, listing candidates to the user, explicit user selection, and a mandatory --yes — plus error-recovery guidance (retry only on rate_limit, fix params otherwise); the validation cap at 3 does not apply because validation is present. | 5 / 5 |
Progressive Disclosure | SKILL.md serves as a clear overview with a shortcuts table linking one-level-deep to 13 reference files, all of which exist in ./references/; detail is appropriately split out and navigation is easy via the table. | 5 / 5 |
Total | 19 / 20 Passed |