Content
51%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.
The body is admirably lean and well-sectioned, but it is a skeleton without an engine: it points to scripts/todo.py which does not exist in the bundle, provides no command syntax or usage examples, and includes no validation around the destructive delete operation. Shipping the script (or documenting its CLI) with usage examples would transform it.
Suggestions
Ship the referenced scripts/todo.py in the bundle (or remove the reference) — the body currently instructs Claude to use a script that does not exist anywhere in the skill.
Add concrete, copy-paste-ready usage examples for each operation, e.g. `python scripts/todo.py add "买牛奶"`, `python scripts/todo.py done 3`, `python scripts/todo.py list --status pending`, so the skill is executable without guessing the CLI.
Add a verification step around the destructive delete operation (e.g., confirm the task ID exists and show the task before deleting, or verify the deletion succeeded) — destructive operations without validation cap workflow clarity at 3.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~20 lines with zero padding and no explanations of concepts Claude already knows — sections ("## 功能", "## 触发场景", "## 脚本") each earn their place, matching the anchor 'lean and efficient; assumes Claude's competence; every token earns its place'. It is not 4 because there is nothing that could be trimmed. | 5 / 5 |
Actionability | The only concrete guidance is "使用 `scripts/todo.py` 进行持久化操作,数据存储在工作区的 `todos.json` 中" plus a trigger-to-operation mapping — minimal concrete pointers with no specific steps to execute (no command syntax, arguments, or examples for todo.py). It sits at the 'minimal concrete guidance; missing the specific steps to execute' anchor rather than 1 because concrete artifacts (script path, data file) are named; it cannot be 3+ because the referenced scripts/todo.py does not exist in the bundle, leaving nothing executable at all. | 2 / 5 |
Workflow Clarity | The body maps triggers to operations ("完成了任务 X"→mark complete, "删除任务 X"→delete) but defines no step sequence for actually performing an operation, and the destructive delete operation has no validation/verification step — which per the judging guidelines caps workflow clarity at 3. It scores 2 rather than 3 because no steps are listed at all (the mapping is not a step sequence) and validation is entirely absent; it is above 1 because the capabilities and trigger mapping are coherently organized. | 2 / 5 |
Progressive Disclosure | The short body is well-sectioned (matching the simple-skill pattern), but its single external reference "scripts/todo.py" is dangling — no scripts/ directory or any bundle file exists — so the reference resolves to nothing and Claude would try to read a missing file. This fits 'references present but not clearly signaled' territory more than the 4 anchor's 'minor organization gaps', because a broken reference is a functional navigation defect, not just an organizational one. | 3 / 5 |
Total | 12 / 20 Passed |