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, highly actionable skill body: an explicitly sequenced 7-step workflow with real validation feedback loops, copy-paste commands, and clean one-level-deep reference structure. The two minor issues are a missing referenced example bundle (examples/secrets-module/) and a small amount of inline content that could live in a reference file.
Suggestions
Ship the examples/secrets-module/ bundle (storyboard.json and slides.py) that the workflow tells the reader to start from, or remove/redirect the dangling reference.
Move the verbatim YouTube embed iframe (and similar publish boilerplate) into a reference file, keeping only the embedding rule and placement guidance inline.
Consider moving the letter-by-letter spelling rules ("A.S.P." pacing guidance) into scripts/narrate.py's docs or references/storyboard.md, keeping just the pointer and the "confirm with a person" rule inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and command-first with no explanations of concepts Claude already knows; explanatory asides carry non-obvious, project-specific rationale ("the recorder must not pick up the repository's build settings"). Not 5: a few elements could be trimmed or moved, e.g. the inline iframe embed HTML and the letter-spacing pronunciation detail. | 4 / 5 |
Actionability | Copy-paste ready throughout: exact commands ("python .agents/skills/orchardcore-video-producer/scripts/narrate.py <workspace>", "export VIDEO_ROOT=<workspace> VIDEO_BASE_URL=http://localhost:5010", "CRF=34 python .../assemble.py <workspace>"), a concrete workspace layout, and the verbatim embed iframe. Covers the common cases end to end. | 5 / 5 |
Workflow Clarity | Seven clearly numbered steps with explicit validation checkpoints and feedback loops: "Look at every contact sheet (<shots>/<clip>.jpg) before assembling", "If it's over 10 MB... raise the CRF one step at a time", "Extract a few frames with ffmpeg and look at them", and "Check the page with mkdocs build". | 5 / 5 |
Progressive Disclosure | Good structure: a summary spec table pointing to references/specs.md, one-level-deep well-signaled references (storyboard.md, recording.md, scripts), and a References index. Not 5: the body directs readers to start from "examples/secrets-module/storyboard.json" and "slides.py", but no examples/ directory exists in the bundle — a dangling reference. | 4 / 5 |
Total | 18 / 20 Passed |