Content
92%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 dense, highly operational skill file: exact commands with flags, a fixed pipeline order, gated QC publication, explicit error-to-fix mappings, and a well-wired one-level reference bundle. Its only real cost is redundancy — the route priority and the sheets-vs-character-animation scope rule are each repeated two to three times across sections.
Suggestions
State the art-route priority (API key, then host tool / signed-in CLI, then codeart2d on no-route) once in the 'Art source' section and reduce the Master still step-2 restatement to a pointer, keeping only the exit-3 handling.
The rule that sheets are for FX, icons and props (not character animation) appears in 'Art source', 'Master still', and 'Pipeline'; keep it in the pipeline-defining location and reference it from the others.
The 'Master still' intro paragraph repeats the video2dsprite handoff and sheets scope nearly verbatim from 'Art source'; trim it to the pointers it already contains ([video-handoff.md], [master-still.md]).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is extremely lean and assumes Claude's competence (no concept explanations — 'A grid is not smoothness: pose spacing, timing, the loop seam and ground contact matter more'), but a few rules are stated multiple times: 'sheets are for FX, icons and props' appears in the Art source section, the Master still intro, and the Pipeline section, and the route ordering (API key first, then local, codeart2d fallback) is enumerated in Art source and restated in Master still steps 2 and the exit-3 handling. This matches anchor 4 ('efficient; minor instances that could be trimmed') rather than 5, since not quite every token earns its place. | 4 / 5 |
Actionability | Fully executable commands throughout: 'python "<skill-dir>/scripts/master_still.py" generate --spec <json> --takes 3 --output-dir <new>' plus a complete spec flag list (--name, --subject, --facing left|right|front|back, --finish hd|pixel, --key default #FF00FF), a needs→command pipeline table with concrete flags ('scale_frames.py --frames <pngs> --root-lock torso-x --row-baseline --emit-clips'), defined exit codes (1 errors, 2 usage, 3 no-route) with prescribed responses, and '--help lists every flag' for the remainder. Copy-paste ready and covering the common cases — anchor 5, not 4, since no key detail is missing that a flag or reference doesn't supply. | 5 / 5 |
Workflow Clarity | The Master still section is a numbered 6-step sequence (Spec → Generate → Choose → Fix by edit → Approve → Motion steps) and the Pipeline section fixes an exact order ('sheet_qc.py spill on the raw sheet, then generate2dsprite.py process, then sheet_qc.py frames, then scale_frames.py...'). Validation is explicit and gated ('--strict-qc / --strict publish nothing on failure', 'Report every WARN or FAIL check verbatim'), with error-recovery feedback loops ('Fix a near-miss by edit, never by re-roll', 'a key_ring_spill warning: add --despill-radius 1 or --key-quality soft', 'Exit 3 means no route: say so; codeart2d is the fallback') and an Acceptance checklist. This is anchor 5; batch operations here do have validation, so no cap applies. | 5 / 5 |
Progressive Disclosure | The ~106-line body is a genuine overview: each decision point links its one-level-deep reference inline ('Wording: [prompt-rules.md]; commands, framing and master.json: [master-still.md]'), the pipeline table rows link their detail files ([processing.md], [modes.md], [frames-and-clips.md], [palette-and-pixels.md], [engine-export.md]), and a final References section indexes all of them with scope notes. All 12 referenced .md files, the referenced scripts, and references/schemas/sprite.schema.json exist in the bundle, and scripts defer their full API to --help. Clear overview, well-signaled one-level-deep references, easy navigation — anchor 5 rather than 4 because nothing that belongs in a reference file is inlined wholesale. | 5 / 5 |
Total | 19 / 20 Passed |