Content
85%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-engineered instruction skill: concrete commands, explicit budgets, error-recovery paths, and a clean one-level reference structure, with the anti-hardcoding stance explicitly justified. Its only real cost is modest redundancy in the repeated AI-source rules.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is directive and lean with essentially no explanation of concepts Claude already knows; every section adds tool-specific rules the model could not infer. Minor redundancy — the 'one AI source only' rule is restated across 主路由规则, 频率限制, and AI 源选择 — keeps it below the 'every token earns its place' anchor. | 4 / 5 |
Actionability | Concrete commands (`opencli list -f yaml`, `opencli <site> -h`, `opencli <site> <command> -h`), hard numeric limits (max 1 AI call, max 2 non-AI calls), a fixed ledger schema, and a copy-paste report template make the guidance mostly executable. Placeholders instead of full search invocations are explicitly justified ('以 `opencli ... -h` 的实时输出为准'), so no penalty applies, but no concrete end-to-end example exists either, holding it at 4 rather than 5. | 4 / 5 |
Workflow Clarity | The workflow is clearly sequenced: a mandatory two-stage precheck (registry → site help → subcommand help), a single routing rule, an incrementally updated call ledger, and a mandatory post-query report. Validation checkpoints are explicit (verify sites against live registry before use) and error-recovery loops are spelled out for both rate limits (record skip → switch source → answer with stated gaps) and unavailable sources (do not abort → record → fall back). | 5 / 5 |
Progressive Disclosure | The SKILL.md body is an overview only, and the 参考文件 section clearly signals eight one-level-deep, domain-organized references (`references/sources-ai.md` … `sources-other.md`), all of which exist and contain no further nesting. The instruction to load only files relevant to the current query rounds out easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |