Content
65%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 exemplary token-efficient routing document whose decision tree and file-location table demonstrate strong structure, but as shipped it is a pointer skeleton: all four referenced guides/checklists are missing from the bundle, so the actual integration steps, validation checkpoints, and reference material the body promises are unreachable. The routing quality earns high conciseness, but actionability, workflow clarity, and progressive disclosure are capped by content that exists only as broken links.
Suggestions
Ship the referenced bundle files (guides/quick-start.md, guides/full-integration.md, checklist.md, reference/README.md) or remove/inline their content — as delivered, every link in the body is broken.
Inline a minimal 5-step quick-start directly in SKILL.md so the skill remains actionable even if a guide is missing, matching the description's promise of minimal integration.
Add a validation checkpoint to the flow (e.g., a test command or verification step for the new resource's auth) so the workflow includes at least one explicit checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean ~30-line router: an ASCII decision tree, a quick-links table, and a three-row code-location table, with zero explanation of concepts Claude already knows and no padding. Every line is either a routing decision, a link, or a concrete file path — matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | The code-location table is concrete ('packages/global/support/permission/constant.ts — 添加 PerResourceTypeEnum', auth.ts paths), but the body contains no executable steps, commands, or code — all actual instruction is delegated to guide files. This matches 'some concrete guidance but incomplete; missing key details', and critically the delegated guides (./guides/quick-start.md, ./guides/full-integration.md) are not present in the bundle, so as shipped the skill stops at file pointers. | 3 / 5 |
Workflow Clarity | The decision tree cleanly routes the user to one of two paths, which is a clear selection flow, but there is no implementation sequence in the body — no ordered steps, no validation checkpoint (e.g., how to verify the new resource's auth works before finishing), and the checklist link that might supply them points to a missing file. This sits at 'sequence present but checkpoints missing or implicit', and cannot go higher while the actual steps are unreachable. | 3 / 5 |
Progressive Disclosure | The body structure itself is good — a well-signaled overview with one-level-deep links organized in a quick-links table. However, scoring against the actual bundle structure: none of the four referenced files (./guides/quick-start.md, ./guides/full-integration.md, ./checklist.md, ./reference/README.md) exist in the skill directory, so navigation breaks at the first hop. Good skeleton, broken targets — between the 'good structure' (4) and 'references present but not clearly signaled' (3) anchors, pulled to 3 by the broken links. | 3 / 5 |
Total | 14 / 20 Passed |