Content
82%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.
An efficient, highly actionable rules-base skill body with a well-designed strong-trigger reference index and a properly gated high-risk approval workflow. Its weaknesses are minor: no complete worked command examples inline, core workflows delegated to references without inline checkpoints, and one orphaned bundle file.
Suggestions
Add one or two complete copy-paste command examples for the most common cases (e.g. `lark-cli auth login --as user` and a full `lark-cli auth qrcode --output qr.png` invocation) so guidance is fully executable without consulting references.
Either link `lark-wiki-token-routing.md` from the trigger index (or another appropriate section) or remove it from this skill's bundle so every references/ file is discoverable from SKILL.md.
Include a brief inline validation step for the auth/config workflows (e.g. verify identity with a status check after login) rather than relying entirely on the referenced files for checkpoint guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~40-line body is dense and prescriptive with zero padding: every rule carries non-obvious operational fact (the `ok == true` vs `code == 0` envelope trap, exit-code-10 approval gate, relative-path-only file arguments, QR-code pairing rule). It assumes Claude's competence and explains nothing the model already knows, matching the 'lean and efficient; every token earns its place' anchor — the one justification sentence (misjudging success via the legacy OpenAPI format) is a genuine gotcha, not filler. | 5 / 5 |
Actionability | Guidance is concrete and executable: exact commands (`lark-cli auth qrcode` with `--output`/`--ascii`), exact flags (`--dry-run`, `--format json`, `--as user/bot`), exact envelope fields (`ok`, `risk: "high-risk-write"`, `hint`), and precise procedures (append the confirmation flag to the end of the original argv). It stops short of the 5 anchor because there are no complete copy-paste example invocations for the common cases (e.g. a full `auth login` or qrcode command line with arguments), leaving minor gaps; it is well above 3 since nothing is pseudocode or vague. | 4 / 5 |
Workflow Clarity | The high-risk flow is an explicit, well-checkpointed sequence — exit 10 → stop → show `action`/`risk`/key params to the user → obtain explicit consent → append the hinted flag to the original argv → retry — with a genuine feedback (retry) loop and a hard validation gate (user confirmation). It sits at 4 rather than 5 because the body only sequences this one procedure; the other core workflows (login, identity diagnostics, config init) are deferred to references without inline validation steps, and the multi-step procedures that are present stop just short of full checklists. | 4 / 5 |
Progressive Disclosure | Structure is strong: a clear overview split into general rules, security rules, and a MUST-read trigger-index table that maps trigger conditions to the correct reference file, specifies reading order, and deduplicates repeat reads; all five referenced files exist and are one level deep. Scored against the actual bundle, it lands at 4 rather than 5 because the references directory contains a sixth file, `lark-wiki-token-routing.md`, that is not navigable from SKILL.md — a minor organization gap consistent with the 4 anchor ('references mostly clear; minor organization gaps'). | 4 / 5 |
Total | 17 / 20 Passed |