Content
90%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 routing-index skill body: scenario-first routing to real, well-signaled reference files, read-once discipline, deterministic local-file resolution rules, and an auth error-recovery loop, all with zero padding. The two 4-level dimensions reflect validation being delegated to references for destructive ops, and a partially second-level reference graph plus non-resolvable cross-skill links.
Suggestions
Add a one-line validation/reversal checkpoint next to the destructive shortcuts (+resource-delete, +history-revert, +resource-update) in the routing table so the safety cue exists at SKILL.md level, not only inside the reference files.
Surface the second-level references (genres/ templates, lark-doc-xml.md / lark-doc-xml-extended-blocks.md / lark-doc-md.md) with a brief mention in the relevant routing entries (e.g. under 创建工作流 and +fetch/+update) so they are discoverable from the overview in one hop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean ~40-line routing index: every line is a decision rule or scenario→shortcut→reference mapping with zero concept explanations and no padding. Detail is delegated to reference files, fully respecting Claude's competence. | 5 / 5 |
Actionability | Every scenario maps to a named shortcut (+fetch, +update, +media-insert, …) and a real reference file, with concrete flag guidance ('文档操作推荐显式指定 --as user') and deterministic file-resolution rules. As an instruction-only router the guidance is fully specific and executable; absence of inline code is appropriate, not a gap. | 5 / 5 |
Workflow Clarity | The entry sequence is explicit and sequenced ('先判断场景，再读取该场景的参考文件；每个文件只在首次进入对应阶段时读取一次') and includes a feedback loop for auth/scope errors (read lark-shared, fix, retry), plus the whiteboard token-reuse guard. Not a 5 because validation for destructive/batch operations it routes to (+resource-delete, +history-revert) is entirely delegated to references with no checkpoint at this level. | 4 / 5 |
Progressive Disclosure | Clear overview where all 12 referenced files in references/ exist and are one hop from SKILL.md, each clearly signaled by scenario. Not a 5: some bundle content (genres/*.md, lark-doc-xml.md, lark-doc-md.md, lark-doc-xml-extended-blocks.md) is only reachable via a second hop through other references, and the ../lark-whiteboard, ../lark-shared, ../lark-drive links do not resolve within this bundle. | 4 / 5 |
Total | 18 / 20 Passed |