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, dense skill body: every need maps to a runnable command, validation is baked into the tools and reinforced with feedback loops, and detailed formats live in real one-level-deep reference files. The only deductions are minor: the routing rule is repeated across three sections plus host notes, and the referenced examples/ directory is absent from the bundle.
Suggestions
State the routing rule (code art last resort, image generation first) once — e.g. in 'Do not use when' — and let the 'Art source' paragraph and host notes carry only their unique details.
Ship the examples directory referenced in 'Commands' ('Examples to copy: examples/') or remove the pointer so every referenced path resolves.
Consider folding the per-host notes into a short table (host | art tooling | how to view previews) to cut the repeated framing text.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with zero concept-teaching (no 'what is SVG' padding; it assumes Claude knows parallax, collision, IoU). However, the routing rule (code art is the last resort; image generation comes first) is restated in 'Do not use when', the 'Art source' paragraph, and all three host notes — minor duplication that could be consolidated. That matches anchor 4 ('Efficient; minor instances of over-explanation that could be trimmed') rather than anchor 5, and it is well above anchor 3 since nothing explains things Claude already knows. | 4 / 5 |
Actionability | Fully executable throughout: a copy-paste Hello sprite ('python "<skill-dir>/scripts/render_pixelspec.py" --spec gem.pixelspec.json --output-dir out/gem-v1 --preview-scale 8 --strict-qc'), a Pipeline table mapping every need to an exact command with flags, pinned install commands ('python -m pip install "resvg-py>=0.5,<0.6"'), and explicit error semantics ('Success prints one JSON line; errors print "error: ..." and exit 1'). This matches anchor 5 ('fully executable; copy-paste ready; specific examples cover the common cases') — no pseudocode or vague direction anywhere. | 5 / 5 |
Workflow Clarity | Clear sequences with explicit validation and feedback loops: a numbered Hello sprite walkthrough, a capability check with remediation ('If encoding.stdout fails, set PYTHONUTF8=1'), QA gates that fail closed ('with --strict-qc a failed check publishes nothing', tilesets 'seam-proven before they are published'), and a warn-fix-retry loop ('render_pixelspec.py warns half_cycle_duplicates ... fix the legs, or pass --allow-duplicate-half-cycle only after the review sheet shows the stride reads'). The Acceptance section adds a reporting checklist. This matches anchor 5 ('explicit validation steps; feedback loops for error recovery'); the anchor-4 profile ('minor validation gaps') does not apply. | 5 / 5 |
Progressive Disclosure | Well-structured overview with one-level-deep, clearly signaled references: all ten linked reference files (pixelspec.md, svg-profile.md, rig-animation.md, fx-language.md, fx-runtime-contract.md, tiles-and-maps.md, layouts-and-parallax.md, style-envelope.md, rasterizers.md, schemas/codeart.schema.json) exist and are substantial, and detail is correctly split out of SKILL.md. However, the body points to an examples directory ('Examples to copy: examples/') that is not present in the bundle, and the pipeline/hand-off detail is excellent but the missing referenced path is a minor navigation gap — anchor 4 ('good structure ... minor organization gaps') rather than anchor 5, since scoring is against the actual bundle. | 4 / 5 |
Total | 18 / 20 Passed |