Content
71%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 well-structured skill body with a clear staged workflow, explicit review gates and recovery loops, copy-paste-ready generation and compile commands, and exemplary progressive disclosure into eight real, well-signaled reference files. The main weaknesses are repeated restatement of the AI-graphics limits with conflicting numbers across sections, which both pads the document and muddies the validation thresholds.
Suggestions
State the AI-graphic limits once (in the hard-limits table) and have Stage 2 and Common Pitfalls reference them instead of restating conflicting numbers (3-4 vs 4-5 elements, 10 vs 15 words).
Collapse the Common Pitfalls 'Best Practices' checklist into the pitfalls list (or move both to a reference file) — it almost entirely restates the hard limits and pitfalls.
Show a one-line usage example for 'review_poster.sh' (e.g. 'bash scripts/review_poster.sh poster.tex') so both helper scripts are copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — hard-limit tables, concrete commands, and a staged workflow — but the AI-graphics limits are restated in at least three places with conflicting numbers ('3-4 maximum' vs 'Maximum 4-5 elements' vs 'Keep to 3-5 max'; '10 maximum' vs 'Maximum 15 words'), and the long Common Pitfalls / Best Practices checklists restate the same rules again. Fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; not 2 because the bulk of the content is actionable guidance Claude does not already know, not filler. | 3 / 5 |
Actionability | Concrete executable commands throughout: 'mkdir -p figures', full 'python scripts/generate_schematic.py' invocations with complete prompts, 'tlmgr install beamerposter tikzposter baposter', 'pdflatex poster.tex', and 'grep -i overfull poster.log'. Not 5 because 'review_poster.sh' and 'generate_schematic_ai.py' are named but their usage is never shown, so those parts are not copy-paste ready. | 4 / 5 |
Workflow Clarity | A clear six-stage sequence with two mandatory review gates ('Before generating... After generating, before assembly'), explicit recovery loops ('Any failure means regenerate or split'), and post-compile validation ('run grep -i overfull poster.log and inspect all four edges'). Not 5 because the validation thresholds are internally inconsistent — the hard-limit table says 3-4 elements max and 10 words, Stage 2 says 4-5 elements and 15 words, and the review step says 'More than 5? → Regenerate' — leaving the checkpoint ambiguous. | 4 / 5 |
Progressive Disclosure | The body is an overview with hard limits, and all detail is cleanly split into eight one-level-deep reference files (ai_graphics_for_posters, latex_poster_reference, compilation_and_quality_control, poster_patterns_and_presentation, plus package/layout/design/content guides), each listed with a one-line scope description and all verified to exist. Scripts and asset templates are also clearly signaled. Matches the anchor: clear overview with well-signaled one-level-deep references and easy navigation. | 5 / 5 |
Total | 16 / 20 Passed |