Content
88%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.
The content is a strong, highly actionable manual: nearly every line is environment-specific knowledge Claude could not infer, and the workflows bake in validation and feedback loops. Its main weaknesses are mild duplication of a few warnings and a monolithic single-file layout where the design guidance could be moved to reference files.
Suggestions
Deduplicate the thumbnail-overwrite warning and the '--original' rationale by stating each once (e.g., only in the Editing and File QA sections) and cross-referencing from the Scripts table.
Move the Design Ideas section (palette table, layout options, typography details) into a references/ file (e.g. references/design.md) and keep a short summary with a clear link in SKILL.md to reduce always-loaded tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with environment-specific, non-obvious knowledge (hex-color corruption, 'charSpacing' vs 'letterSpacing', the secondaryValAxis axis-id bug, QA font substitution), but a few warnings are duplicated — the thumbnail-overwrite caveat appears in both the Scripts table and the Editing section, and the '--original' rationale is repeated in the Scripts table and File QA — so it is efficient with minor trimming opportunities rather than lean throughout. | 4 / 5 |
Actionability | Guidance is fully executable throughout: complete bash blocks for unpack/edit/pack/validate, exact script invocations with flags, literal hex palette values, precise pptxgenjs option names, and a copy-paste icon-rendering pipeline, covering the common create/edit/read cases. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints and feedback loops: structural work is ordered before content edits, 'After writeFile(), run python scripts/office/validate.py' mandates validation, failures instruct fixing in the generator and rebuilding, and the QA section requires re-rendering after fixes — matching the top anchor including for the destructive/batch XML editing flow. | 5 / 5 |
Progressive Disclosure | The bundle structure is good: all five scripts in scripts/ (thumbnail.py, add_slide.py, clean.py, office/validate.py, office/soffice.py) are real files documented in a Scripts table with invocations and caveats, and sections use clear cross-links. However, everything lives inline in one ~230-line SKILL.md — the ~80-line Design Ideas section and detailed QA checklist could be split into one-level-deep reference files, which keeps it below the clear-overview-with-references anchor. | 4 / 5 |
Total | 18 / 20 Passed |