Content
100%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 lean skill body: executable commands with concrete examples, a clearly sequenced three-step workflow with explicit error-case handling and a verification checklist, and clean section structure with no padding. The instruction-only format is fully appropriate given the concrete, specific guidance provided.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~58-line body is lean and assumes Claude's competence throughout: no git or session-tracking concepts are explained, every section (Quick start, Why, Workflow, Anti-patterns, Checklist, See also, Troubleshooting) earns its place, and the example is minimal but complete. Nothing matches the over-explanation patterns of the lower anchors. | 5 / 5 |
Actionability | All guidance is copy-paste executable with real arguments and a concrete expected-output sample: `git blame -L 40,52 src/auth/refresh.ts`, `git log -L :<function>:<file>`, `git log -n 1 -- <file>`, and `memory_commit_lookup { "sha": "..." }`. The WRONG/RIGHT anti-pattern pair shows exactly what output to produce in the null case, covering the main cases per the top anchor. | 5 / 5 |
Workflow Clarity | The three-step workflow (find SHA → lookup → present) is clearly sequenced, and it includes explicit checkpoints: the `commit: null` case is handled with a directed recovery message, and the Checklist section verifies each step (SHA provenance, no fabricated sessions, verbatim quoting). This is a read-only lookup skill, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | This is a short, single-purpose skill with no bundle files (no references/, scripts/, or assets/ directories), so nothing needs splitting; sections are well-organized and navigable. The one external pointer (../_shared/TROUBLESHOOTING.md) is clearly signaled, condition-scoped, and one level deep, satisfying the simple-skill guideline for a top score. | 5 / 5 |
Total | 20 / 20 Passed |