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.
The body is an exemplary CLI skill: lean command tables, copy-paste-ready invocations, and a tightly sequenced workflow with validation and recovery at every step. Bundle structure matches the reference table exactly, making navigation trivial. No material weaknesses found.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and telegraphic — dense command tables ("Commands by job", "Render where", "When a command fails") with zero explanation of concepts Claude already knows; every line carries operational information. Not 4 because there is no over-explanation to trim; even behavioral notes (usage beacon, updateNotice) are actionable instructions, not padding. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands with exact flags throughout: `render --quality looks -o out.mp4`, `timeline apply plan.json --json` with a concrete JSON edit-file example, the `until grep -qE 'Render (complete|failed)' render.log; do sleep 5; done` wait loop, and a symptom→fix failure table. Not 4 because the commands cover the common cases with specific flags and outputs, leaving no significant gaps. | 5 / 5 |
Workflow Clarity | "The loop" gives a clear 5-step sequence with explicit validation checkpoints (lint after first pass, `check --json` fix every error, read snapshot PNGs, preview URL must answer 200, confirm non-empty render with ffprobe duration matching data-duration), plus feedback loops for recovery (failure table, `--plan` previews before edits, `clean --dry-run` before `clean`, `history undo`). Not 4 because validation is explicit at every step, including for the destructive `clean` and edit operations. | 5 / 5 |
Progressive Disclosure | A ~100-line overview keeps SKILL.md as a map: a References table ("Read the row before running its command") routes each command group to one-level-deep reference files, and all 12 local references (init-and-scaffold, lint-validate-inspect, preview-render, cloud, lambda, etc.) exist in the bundle. Not 4 because the split is appropriate and navigation is explicit; the few ../hyperframes cross-skill links are clearly signaled plugin-level references. | 5 / 5 |
Total | 20 / 20 Passed |