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.
The body is an exemplary lean, operational skill: concrete CLI commands, a gated five-step workflow with a preview checkpoint and anti-fabrication reporting rules, and proper deferral of shared details to a single external guide. The only improvements are incremental — an inline YAML skeleton and explicit failure-handling branches would make it fully copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout: no concept explanations, each sentence adds project-specific constraints ('Do not fabricate AR/IC/drawdown, skip missing PIT evidence, treat unknown usage as zero'), and every token carries guidance Claude could not infer. It assumes Claude's competence and matches anchor 5. | 5 / 5 |
Actionability | Concrete, executable commands are given ('python egs/skills.py preview --config <task.yaml>', 'run --config <task.yaml> --format jsonl', 'providers --probe', 'show/events/files/cancel') plus a pointer to a real example YAML. Minor gaps keep it below anchor 5: no inline task-YAML template or field list, and 'providers --probe' is given without its full command prefix. | 4 / 5 |
Workflow Clarity | Five numbered steps form a clear sequence (read example → create YAML → preview → run once → report actual results), with a pre-run checkpoint (preview, probe when backend availability is uncertain) and error-recovery guidance ('retain failed-run evidence instead of repeating paid calls'). It falls short of anchor 5 because there is no explicit if-fails-then-fix loop for the preview step and no checklist for the reporting step. | 4 / 5 |
Progressive Disclosure | The body is a short, well-organized overview that keeps provider limits, data fields, and research gates in a single clearly signaled one-level-deep reference ([the shared execution guide](../../../docs/usage/agent_cli_skills.md)). No bundle files exist to inline, content is appropriately split, and navigation is easy — matching the simple-skill case for a top score. | 5 / 5 |
Total | 18 / 20 Passed |