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 command reference: fully concrete, zero padding, sensibly sectioned. The only real gaps are the elided `--action '...'` placeholder in the motion-watch command and the unspecified config.yaml format, which keep actionability and workflow clarity just short of top marks.
Suggestions
Replace the `--action '...'` placeholder with one real example action (e.g. `--action 'save --out motion.mp4'`) so the motion-watch command is actually runnable.
Show a minimal `~/.config/camsnap/config.yaml` example so manual config editing is as actionable as the CLI.
Add one line making validation explicit in the workflow, e.g. 'If a capture fails or hangs, run `camsnap doctor --probe` before adjusting settings.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a command, path, or operational note ("camsnap snap kitchen --out shot.jpg", "Requires ffmpeg on PATH"); there is no padding and no explanation of concepts Claude already knows. This matches the lean anchor 5 exactly. | 5 / 5 |
Actionability | Commands are copy-paste ready for add/discover/snap/clip/doctor, matching anchor 4 (mostly executable, minor gaps). Not a 5 because `--action '...'` is a literal elided placeholder rather than a runnable example, and the expected structure of `~/.config/camsnap/config.yaml` is never shown. | 4 / 5 |
Workflow Clarity | A clear setup-then-use sequence is present (Setup → Common commands) with `camsnap doctor --probe` as a diagnostic and "Prefer a short test capture before longer clips" as a soft checkpoint, matching anchor 4. Not a 5 because validation is offered as an optional command rather than an explicit step in the capture workflow (e.g. run doctor when a capture fails). | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references, and its well-organized sections (Setup, Common commands, Notes) cover it cleanly — the rubric's simple-skill guidance says this earns a 5. No bundle files exist to reference, and none are needed. | 5 / 5 |
Total | 18 / 20 Passed |