Content
96%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 exemplar of dense, executable CLI guidance: commands by job, a gated write-check-snapshot-preview-render loop with real validation checkpoints, and a symptom→fix failure table. Progressive disclosure is well handled via a command-to-reference table whose targets all exist, docked only for cross-bundle references that don't resolve here.
Suggestions
Make the three cross-skill references (`../hyperframes/references/plugin-installation.md`, `format.md`, `motion.md`) resolve within this bundle, or inline the few sentences they carry so no path leaves the skill directory.
Clarify what to do when the referenced sibling HyperFrames plugin is absent, since the plugin-installation note is the first instruction in the body but unverifiable from this bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense throughout: command tables, one-line requirements ("It needs Node.js 22+ and FFmpeg"), targeted pitfalls ("never `pgrep -f`, which matches its own loop"), and deprecated aliases quarantined in a single note. Assumes Claude's competence with no concept explanations; every token earns its place. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands everywhere: `npx hyperframes check --json`, `render --quality looks --output out.mp4`, `timeline apply plan.json --json`, and a concrete wait loop `until grep -qE 'Render (complete|failed)' render.log; do sleep 5; done`. Specific examples cover the common cases, including failure recovery commands. | 5 / 5 |
Workflow Clarity | "The loop" is a clearly sequenced 5-step process with explicit validation checkpoints: lint after structural changes, `check --json` as the gate, reading snapshot PNGs, confirming the preview URL answers 200, and verifying the render is non-empty with `ffprobe` duration matching `data-duration`. Error recovery is strong: a symptom→fix table, `--plan` previews, edit receipts, and `timeline undo`/`history undo` feedback loops. | 5 / 5 |
Progressive Disclosure | Good structure: the body is a concise overview and the "Read the row before running its command" table maps commands to all 12 real, one-level-deep `references/*.md` files, all of which exist. Not 5 because three referenced paths (`../hyperframes/references/plugin-installation.md`, `format.md`, `motion.md`) point outside this bundle and do not resolve in the actual file structure, leaving minor navigation gaps. | 4 / 5 |
Total | 19 / 20 Passed |