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.
The body is an exemplary lean, command-first reference: executable examples for every capability, well-labeled sections, no padding, and no unnecessary bundle files. The only notable gap is that the search→download→extract pipeline is stated but never connected end-to-end (download location vs. the './clip.gif' input used in extraction examples), which costs a workflow checkpoint.
Suggestions
Bridge the download→extract stages: show how to reference the file saved to ~/Downloads in the still/sheet commands (e.g. 'gifgrep still ~/Downloads/<name>.gif --at 1.5s'), including a quick existence check after --download.
Note the platform constraint on '--reveal' (Finder is macOS-only) so non-macOS users aren't misled.
Reconcile the invocation styles shown ('gifgrep search --json cats' vs 'gifgrep cats --json') so it is clear which argument order is canonical.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-driven — every line is an executable command, a flag fact, or an environment toggle, with zero explanation of concepts Claude already knows. This matches the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Quick start and each section provide copy-paste-ready commands covering the common cases: search ('gifgrep cats --max 5'), JSON output ('gifgrep search --json cats | jq ...'), piping ('--format url'), TUI ('gifgrep tui'), still and sheet extraction with tunable flags. This matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The pipeline is explicitly stated ('Search → preview → download → extract (still/sheet)') and sections map to those stages, matching 'clear sequence with most checkpoints'. It is not 5 because the stages are not linked: downloads go to '~/Downloads' with no example of locating the downloaded file, while the still/sheet examples use './clip.gif' — a disconnect with no verification checkpoint bridging download to extraction. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external references needed; sections are well-organized and clearly labeled. Per the rubric's simple-skill scoring note, this warrants a 5 with just well-organized sections. | 5 / 5 |
Total | 19 / 20 Passed |