Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced skill body with strong validation feedback loops and properly structured one-level-deep references to real bundle files. The main weakness is conciseness: the poster-format readability rules are repeated across four sections and could be consolidated.
Suggestions
Consolidate the poster-format font/element rules (the POSTER FORMAT REQUIREMENTS block, Step 0 checklist, Step 2b checklist, and Common Pitfalls) into a single authoritative section to remove ~40% of the repetition.
Since `assets/poster_quality_checklist.md` already exists, replace the inline Step 0 / Step 2b / After-Export checklists with a brief pointer to that file rather than duplicating them in the body.
Trim the restated "When to Use" / "DO NOT use" guidance that overlaps the frontmatter description and the Overview section to reduce token overhead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is roughly 400 lines and restates the same poster-format rules (3-4 elements max, 50% white space, GIANT 100pt+ text) across the font-requirements block, the pre-generation checklist, the post-generation checklist, and Common Pitfalls, which could be tightened considerably; not 1 because it does not explain concepts Claude already knows and the guidance is domain-specific, and not 3 because the repetition is genuine padding. | 2 / 3 |
Actionability | Provides copy-paste-ready executable commands throughout — `mkdir -p figures`, `python scripts/generate_schematic.py "..." -o figures/hero.png`, `cp skills/pptx-posters/assets/poster_html_template.html poster.html`, headless Chrome PDF export, LibreOffice conversion, and a python-pptx example; not 2 because the code is concrete and runnable rather than pseudocode. | 3 / 3 |
Workflow Clarity | A clear five-stage sequence (Planning → Generate Visuals → Create HTML → Export PDF → Convert PPTX) with mandatory validation checkpoints (Step 0 Pre-Generation Review, Step 2b Post-Generation Review with PASS/FAIL criteria, After-Export checklist) and regenerate feedback loops; not 2 because validation is explicit, not implicit. | 3 / 3 |
Progressive Disclosure | Points to real, one-level-deep bundle files that all exist on disk — `assets/poster_html_template.html`, `assets/poster_quality_checklist.md`, and three `references/*.md` guides — with dedicated Template Assets and References sections giving one-line descriptions; not 2 because references are clearly signaled and not nested. | 3 / 3 |
Total | 11 / 12 Passed |