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.
An exceptionally actionable body: copy-paste commands, a complete config reference with defaults and error semantics, and a render pipeline with genuine validation checkpoints (--stills pre-check, warning-driven fixes, final watch checklist). The two weaker spots are minor verbosity (opening paragraph duplicating the description, repeated direction emphasis) and missed opportunities to split the two other-capability workflow sections into reference files.
Suggestions
Delete or shrink the opening paragraph after the H1 — it restates the frontmatter description; the body can start at '## Run' with only the one-line format summary.
Move 'Making the hand clip' and 'Making the music bed' (both delegated to other capabilities) into a references/ file (e.g. references/paid-inputs.md), keeping SKILL.md to the free deterministic assembly path and one-line pointers.
State the right-to-left direction once (craft rules) and drop the repetition in the intro, config table, and output sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and functional — tables of commands, config fields with defaults, and hard-error lists — and assumes competence (never explains what FFmpeg or keying is). It is not level 5 because of minor fat: the opening paragraph largely restates the frontmatter description, and the right-to-left direction is emphasized four times (intro, config table, craft rules, output). It is clearly above level 3, which requires 'some unnecessary explanation'. | 4 / 5 |
Actionability | Fully executable throughout: exact invocations ('python3 $S/build_hand_swipe_listicle.py config.json --stills cards/'), curl commands with concrete URLs for the bundled clip and per-style TTFs, a copy-paste JSON payload written via heredoc, a config field table with defaults and aliases, a worked example (scripts/config.example.json — verified to exist), and enumerated hard errors. Matches the level-5 'copy-paste ready, covers the common cases' anchor. | 5 / 5 |
Workflow Clarity | Clear sequence (gather inputs → choices → config → render --stills → full render → review) with explicit validation checkpoints and feedback loops: 'Render --stills first: it is instant and shows the title, colors and cutouts before the full render', hard-error and warning semantics, tuning guidance ('Raise green_margin if skin goes see-through; lower it if green fringe remains'), and a final review checklist with concrete pass criteria (hand opaque, finger up, title fits, labels crisp, slide direction, music to the end). Matches the level-5 anchor. | 5 / 5 |
Progressive Disclosure | Good structure with well-organized sections and real, clearly referenced bundle files (scripts/config.example.json and scripts/build_hand_swipe_listicle.py, both present). It is not level 5 because everything instructional lives inline in this ~165-line SKILL.md: the 'Making the hand clip' and 'Making the music bed' sections are workflows belonging to other capabilities, and the long config/craft-rule reference could sit in a separate file, leaving the overview leaner. It is well above level 3, which requires references that are not clearly signaled or content badly misplaced. | 4 / 5 |
Total | 18 / 20 Passed |