Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, lean skill body with a clear render pipeline, real bundled scripts, and explicit error-recovery guidance. The main gap is the absence of a complete executable example invocation or code block, which keeps actionability below the top anchor.
Suggestions
Add a single copy-paste example invocation, e.g. `python scripts/one_shot.py --config config.example.json`, so the primary render command is fully executable from the body.
Include one short code/config snippet showing the expected config field shape inline (beyond pointing to config.example.json) to make the binding step copy-paste ready.
Consider collapsing the mild duplication of 'Never AI-render text' and 'no paid calls' between the intro and the craft rules/Requires sections to tighten the body further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, dense body that never explains concepts Claude already knows (no primer on PIL/FFmpeg/Chrome); every section (scripts, chroma contract, craft rules, requires) earns its place, so it sits at the 'lean and efficient' anchor rather than the 'could be tightened' level below. | 3 / 3 |
Actionability | Gives concrete guidance — named scripts, the single '--config' flag, a copy-paste 'pip install playwright && playwright install chromium', the config.example.json shape, and exact chroma colors/thresholds — but provides no executable code block or complete copy-paste pipeline invocation, which the code-skill scoring note expects. | 2 / 3 |
Workflow Clarity | The pipeline sequence (build_card -> headless-Chrome screenshot -> compose_carousel) is clear, with a 'watch' QC checkpoint and a chroma-bleed feedback loop ('tighten the window_mask thresholds if it bleeds') plus an explicit Playwright-unavailable fallback sequence. | 3 / 3 |
Progressive Disclosure | The body is an overview pointing one level deep to real bundled scripts (scripts/build_card.py, one_shot.py, compose_carousel.py, config.example.json — all verified present), with clearly signaled references and no nested pointer chains. | 3 / 3 |
Total | 11 / 12 Passed |