Content
93%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-crafted skill body: lean, fully executable CLI guidance organized by user intent, with details properly pushed into three clearly-signaled reference files and explicit cross-skill boundaries. The only minor gap is the absence of a result-verification step for the batch profile query workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven: an intent-to-command table, two compact example blocks, and terse notes on error codes, cross-tenant users, and ID types. No concept Claude already knows is explained, and every section carries actionable information, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Commands are copy-paste ready and cover the common cases: `lark-cli contact +search-user --query "张三" --has-chatted --as user`, the schema-first batch query invocation with concrete JSON params, and `+search-bot` single/multi-keyword forms. Specific flags (--user-id-type, --queries, --as) and the concrete 41050 error code make the guidance fully executable. | 5 / 5 |
Workflow Clarity | The main sequence is explicit with checkpoints: search → confirm open_id → act, plus the instruction to list candidates for the user when multiple hits precede a side-effectful action ("不要擅自选第一条") and a schema pre-check before the batch query. It is not 5 because the batch `user_profiles batch_query` workflow lacks a result-verification step and error recovery is delegated to lark-shared rather than an inline feedback loop; not 3 because the risky (side-effectful) path does have an explicit confirmation checkpoint and the batch query is read-only with a pre-flight parameter check. | 4 / 5 |
Progressive Disclosure | The body is a true overview: a command-selection table linking each intent to one of three one-level-deep reference files (all verified to exist, none containing nested references), with flag tables and parameter details correctly deferred to them. Scope boundaries point to sibling skills, making navigation easy. | 5 / 5 |
Total | 19 / 20 Passed |