Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable body with strong QA workflow and validation loops, held back by an oversized inline design-reference section and two broken file references (editing.md, pptxgenjs.md) plus a dead scripts/office symlink. Tightening the inline reference tables and restoring the missing referenced files would raise both conciseness and progressive disclosure.
Suggestions
Restore or create the referenced files editing.md and pptxgenjs.md (and fix the scripts/office symlink to a real _shared/office directory) so the well-signaled one-level references actually resolve.
Move the 10-row color palette table and 8-row font-pairing table into a separate references file (e.g. design.md) and keep SKILL.md as a lean overview, tightening the inline 'Avoid'/'Don't' lists where items overlap.
Add a one-line note in the Editing Workflow that unpack/pack rely on scripts/office, and confirm those scripts are present, so the brief 'Unpack → … → pack' step is traceable to working tooling.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of concepts Claude already knows, but the 10-row color palette table, 8-row font-pairing table, and layered 'Avoid'/'Don't' lists are generous inline reference material that could be tightened or moved to a reference file. It is not a 3 because not every token earns its place, and not a 1 because it never pads with general explanations. | 2 / 3 |
Actionability | Provides fully executable commands ('python -m markitdown presentation.pptx', 'soffice --headless --convert-to pdf output.pptx', 'pdftoppm -jpeg -r 150 output.pdf slide') plus concrete pt sizes, hex codes, margins, and a copy-paste QA subagent prompt — copy-paste ready, matching the score-3 anchor. | 3 / 3 |
Workflow Clarity | The QA Verification Loop is a clear sequence with explicit validation checkpoints — 'List issues found', 'Re-verify affected slides', 'Do not declare success until you've completed at least one fix-and-verify cycle', plus the grep placeholder check before success — so it is not capped at 2 despite involving batch/destructive-style operations. | 3 / 3 |
Progressive Disclosure | References are well-signaled and one level deep ('Read [editing.md](editing.md)', 'Read [pptxgenjs.md](pptxgenjs.md)'), but those referenced files do not exist in the bundle and 'scripts/office' is a broken symlink, so the navigation points nowhere; per the guideline to score against the actual bundle structure, broken referenced paths cap this at 2 rather than 3. | 2 / 3 |
Total | 10 / 12 Passed |