Content
93%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 simple instruction-only skill: terse, fully actionable commands with worked examples and clear step sequencing. The only improvement area is adding a light verification step after running the save command to close the workflow's feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and efficient: a short intro, five numbered steps, a compact type-prefix list, and three brief worked examples with no padding or explanation of concepts Claude already knows, so every token earns its place. | 5 / 5 |
Actionability | Guidance is fully executable: copy-paste-ready commands (`caliber learn add "<refined learning>"`, the `--personal` variant, `git add CALIBER_LEARNINGS.md`) and complete worked examples covering convention and preference cases. | 5 / 5 |
Workflow Clarity | The five-step sequence is clear with an explicit user-confirmation checkpoint before saving, but there is no post-run validation or error-recovery feedback loop (e.g., checking that the learning was added or handling command failure), which keeps it below the top anchor. | 4 / 5 |
Progressive Disclosure | This is a short (~56-line) single-purpose skill with no bundle files and no need for external references; its well-organized sections (Instructions, Examples, When NOT to trigger) provide clean navigation, satisfying the simple-skill exception. | 5 / 5 |
Total | 19 / 20 Passed |