Content
86%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-structured, token-efficient skill body with executable, accurate examples and appropriate structure for a simple single-purpose lookup. The main defect is a mismatch between the documented usage step (positional <query>) and the script's actual flag-based CLI, plus the undocumented --detail flag.
Suggestions
Fix 使用步骤 step 2 to match the real CLI, e.g. `python scripts/todo_finder.py --keyword "<query>"`, instead of a positional "<query>" argument the script does not accept.
Document the --detail flag and show how it maps to the 详情格式 output described in 输出格式.
Note that flags can be combined (as the --archived --keyword example implies) and what happens when no match is found.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with zero concept explanation: sections are limited to when to use it, three usage steps, a flag table, output format, and copy-paste examples. Every token earns its place and it assumes Claude's competence, matching the 'Lean and efficient' anchor; the only trace of padding ("脚本将返回查找结果") is a single short step, not the 'minor instances' of score 4. | 5 / 5 |
Actionability | The examples are fully executable copy-paste commands whose flags (--id, --title, --keyword, --status, --priority, --archived, --all) match the actual script's argparse interface. It falls short of 5 because 使用步骤 step 2 shows a positional "<query>" argument the script does not accept, and the script's --detail flag is undocumented, leaving minor gaps in covering the common cases. | 4 / 5 |
Workflow Clarity | This is a simple, single-purpose read-only lookup with an unambiguous action, which would normally merit 5 under the simple-skill exception. It drops to 4 because the documented step-2 command (positional "<query>") contradicts every example and the actual CLI, a small but real accuracy gap in the stated sequence; no validation checkpoints are required since the operation is non-destructive. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external reference files, and it is organized into clear, well-labeled sections (适用场景, 使用步骤, 匹配方式, 输出格式, 示例). Its single bundle path, scripts/todo_finder.py, is real and referenced accurately, satisfying the guideline that short simple skills can score 5 with well-organized sections. | 5 / 5 |
Total | 18 / 20 Passed |