Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured CLI skill hub: highly actionable command surface and excellent progressive disclosure into per-command reference files. Its main weaknesses are sheer verbosity with some inline detail duplicating reference files, and the absence of inline validation feedback loops for destructive/batch operations.
Suggestions
Move the inline --download-resources and Sender Name Resolution detail fully into their reference files, leaving only a one-line pointer in the body to tighten conciseness.
Add an inline sequenced workflow with an explicit validation checkpoint (e.g. schema → call → inspect ok:false ledger → retry failures) for batch/destructive operations like chat.members.delete and feed-group batch ops.
Consider splitting the large inline API Resources + permission table into a reference doc, keeping only the shortcut table and identity notes in the overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, factual, and free of basic-concept padding, but at ~240 lines it is voluminous and several inline blocks (e.g. the --download-resources paragraph and Sender Name Resolution) summarize material that also lives in dedicated reference files, so it could be tightened. | 2 / 3 |
Actionability | Gives concrete executable command patterns ("lark-cli im +<verb> [flags]", "lark-cli schema im.<resource>.<method>"), a per-operation shortcut table with identity and key flags, and an explicit schema-before-call instruction with an exact scope table. | 3 / 3 |
Workflow Clarity | Clear guardrails exist (read lark-shared first, run schema before calling, MUST-read card workflow) but there are no inline sequenced validate→fix→retry loops for the batch/destructive operations (member removal, message revoke, batch feed ops), which per the feedback-loops note caps this at 2. | 2 / 3 |
Progressive Disclosure | The body is an overview/index pointing to ~26 verified one-level-deep reference files via clearly signaled markdown links and "[Must-read]" tags, with an organized card/ sub-bundle — textbook progressive disclosure. | 3 / 3 |
Total | 10 / 12 Passed |