Content
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is highly actionable and has excellent workflow clarity with strong validation checkpoints, but it is far too verbose — the AI-graphic sizing guidance is repeated across five near-duplicate sections and large reference-suitable content is kept inline rather than deferred. Consolidating the redundant graphic guidance and moving design/typography/color detail into the existing reference files would materially improve token efficiency and progressive disclosure.
Suggestions
Collapse the five near-duplicate AI-graphic sizing sections (the two CRITICAL sections, Step 0, Step 2, Stage 2, Visual Element Guidelines) into a single canonical block referenced once.
Move the inline design-principles, typography, color-scheme, and accessibility sections into the existing references/poster_design_principles.md and link to them from the body instead of re-stating them.
Trim explanations of concepts Claude already knows (basic font-size advice, 'less is more', generic color-blindness background) and keep only poster-specific, non-obvious guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~1590-line body is heavily verbose and repetitive: the same '3 elements / giant fonts / 60% white space / readable from 12 feet' AI-graphic guidance is restated in at least five near-duplicate sections, with extensive CAPS/bold repetition and basic concepts Claude already knows (typography, 'less is more', color-blind palettes). | 1 / 3 |
Actionability | Provides fully executable, copy-paste-ready guidance throughout — real pdflatex/lualatex commands, full \documentclass and template examples, complete generate_schematic.py invocations with literal prompts, pdfinfo/pdffonts/pdfimages checks, and an entire review_poster.sh script. | 3 / 3 |
Workflow Clarity | Multi-step workflow with explicit validation checkpoints and feedback loops: a mandatory Step 0 pre-generation checklist, Step 2b post-generation PASS/FAIL review with 'DO NOT PROCEED if ANY graphic fails', and Section 11 overflow checks with a ranked fix hierarchy and regenerate-and-retry loop. | 3 / 3 |
Progressive Disclosure | References real one-level-deep files (four references/*.md, assets/ templates, scripts/) with signaled navigation, but the SKILL.md itself re-inlines vast amounts that belong in those references (design principles, typography, color schemes, accessibility), matching the anchor of content that should be separate kept inline. | 2 / 3 |
Total | 9 / 12 Passed |