Content
92%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-engineered skill body: actionable code, a disciplined five-step workflow with a real verification gate, and clean one-level progressive disclosure to real bundle files. Its only weakness is mild verbosity in the reflective closing section and some step prose.
Suggestions
Tighten or cut the final 'Why geometry-based verification, not visual diff' section — its three-drawback list re-states trade-offs already implied by the workflow, saving ~150 tokens.
Compress the prose between Step 4's code blocks into a one-line lead-in per snippet; the code and the 'Customizing the rails' callout already carry the explanation.
Move the six drift-mode bullets under 'Why this is hard' into a one-line summary, since the same modes reappear as severity rubric rows in Step 3 — this removes a near-duplicate enumeration.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with novel domain knowledge (rail constants, Cursor/hero_budget patterns, drift taxonomy) that Claude does not already know, but a few stretches — the closing 'Why geometry-based verification, not visual diff' essay and some explanatory prose around the steps — are mildly editorial and could be trimmed. It is efficient overall, not padded with basics. | 4 / 5 |
Actionability | Provides copy-paste-ready executable code (Cursor class, hero_layout, add_run, rail constants) and concrete commands (extract_pptx.py, verify_layout.py with --content-max-y / --canvas-h flags) covering the common slide types and verification gate. | 5 / 5 |
Workflow Clarity | Five explicitly sequenced steps with a hard validation checkpoint — 'Zero violations is the gate for this re-export is shippable' and verify_layout.py returning nonzero on violations — plus a feedback loop (re-export → verify → fix). Because validation is present, the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview with one-level-deep references that all exist (references/layout-discipline.md, font-discipline.md, audit-table-template.md; scripts/extract_pptx.py, verify_layout.py), each signaled with explicit 'read when …' conditions, keeping the bulk out of the main file. | 5 / 5 |
Total | 19 / 20 Passed |