Content
88%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.
A high-quality operational skill body: copy-paste-ready commands, hard numeric thresholds instead of vague guidance, and a verify-before-deliver loop with real evidence requirements. The main weaknesses are minor duplication that costs tokens and two imperfect bundle references (a missing requirements.txt and externally-pointing doc links).
Suggestions
Add the missing requirements.txt to the bundle (or inline the pip packages), since the body twice points Python audio setup at a file that does not exist.
Deduplicate the determinism guidance: keep section 3 as the normative rules and reduce the section 7 failure table's overlapping rows to symptom → fix pointers.
Consolidate the frame-budget and long-render advice in section 4 into one place, and add a one-line usage example for scripts/audio_check.sh and scripts/sync_check.py to match the other script invocations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational knowledge (subject "at least about 1/3 of the frame height", "hold it about letters / 15 + 1.5 s", "roughly ≤ 300 ms/frame", the 30-minute timebox) and never explains basics Claude already knows, so it sits above a 3. It is not a 5 because there is real duplication: determinism rules appear in section 3 and again in the section 7 failure table, frame-budgeting advice appears twice in section 4, and the rhetorical opening paragraph could be trimmed to one sentence. | 4 / 5 |
Actionability | Commands are copy-paste ready with concrete flags and arguments: the capture invocation (`node "$SKILL_DIR/scripts/capture.mjs" <project_dir> --page index.html --fps 30 ...`), the encode string (`-c:v libx264 -pix_fmt yuv420p -crf 18 ...`), the raw-video pipe format, the concat-join workflow with `chunks.txt`, `contact_sheet.sh` and `check_video.sh` call patterns, and the clip-extraction ffmpeg line, plus a complete seeded-RNG snippet. Specific examples cover the common cases, matching anchor 5; the only unshown invocation (`audio_check.sh`/`sync_check.py`) is a negligible gap. | 5 / 5 |
Workflow Clarity | The workflow is a clearly sequenced pipeline (setup → read guides → spec → deterministic timeline → capture/encode → look at frames → verify) with explicit validation checkpoints and feedback loops: "Repeat this loop at least twice", smoke-test before long runs, `check_video.sh` failing on mismatches, and VERIFY.md requiring pass/fail plus timestamped pixel evidence per must-have ("Do not write 'checked' for anything you did not look at"). This matches anchor 5's explicit validation, error-recovery loops, and checklists; a 4 would lack some of these checkpoints. | 5 / 5 |
Progressive Disclosure | Structure is strong: the body is an overview workflow that routes to eight reference guides via a "Read when the request has…" trigger table (all files exist, one level deep), and helper scripts are invoked by path. It drops below a 5 because of minor gaps: `requirements.txt` is cited for Python audio dependencies but does not exist in the bundle, and the `../../docs/sn-code-video.md` links point outside the skill folder (honestly flagged as repository-only, but dead in a standalone install). | 4 / 5 |
Total | 18 / 20 Passed |