Content
92%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 pointer skill: minimal, fully executable, and version-synced by delegating instructions to the installed CLI, with explicit fallbacks for older versions and missing installs. The single deduction is the version-pinned compat note ("before 0.24") sitting outside a deprecated/old-patterns section, which ages poorly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — "This file is a pointer. The instructions live in the installed `hunk` CLI so they always match its version" — with zero padding. However, "Hunk versions before 0.24" is time-sensitive version-pinned information not placed in a deprecated/old-patterns section, which the guidelines penalize; otherwise this would be a 5, and there is no verbosity that would justify a 3. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands covering the common cases: `hunk skill show hunk-review`, the fallback `hunk skill path hunk-review`, and the install URL for when the CLI is missing. This matches the anchor for copy-paste ready commands whose examples cover the common cases; a 4 would require minor gaps in the commands or coverage. | 5 / 5 |
Workflow Clarity | The sequence is unambiguous with explicit error-recovery branches: "If it fails, print the bundled skill's path instead, then read that file and follow it" and "If `hunk` is not on PATH, ask the user to install Hunk first". Per the simple-skill guidance, a single unambiguous action with these feedback loops scores 5, and no destructive or batch operations are involved. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external reference files (none exist in the bundle), and defers all detail one level deep to the CLI at runtime — the ideal pointer pattern. Well-organized with a clear primary path and fallbacks; this fits the clear-overview, one-level-deep reference anchor rather than the minor-gaps 4 anchor. | 5 / 5 |
Total | 19 / 20 Passed |