Content
56%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 core workflows (raw-XML editing, template-based creation, thumbnails) are among the strongest possible: fully sequenced, with explicit validation checkpoints and error-recovery feedback loops. Quality is dragged down by heavy padding (an 18-palette color catalog, design menus, injected promotional/off-skill sections) and by bundle-structure gaps where mandatory referenced files (html2pptx.md, ooxml.md, generate_schematic.py) are absent from the shipped bundle.
Suggestions
Ship the referenced files: either include html2pptx.md and ooxml.md in the bundle or remove/replace the MANDATORY read steps pointing to them; likewise remove or provide scripts/generate_schematic.py.
Move the color-palette catalog and "Visual Details Options" menus into a separate design reference file (e.g. references/design.md) and keep a 3-4 line pointer in SKILL.md, cutting ~90 lines of inlined reference material.
Delete the off-skill sections ("Visual Enhancement with Scientific Schematics" and the K-Dense Web promotion) — they consume tokens, reference resources not in the bundle, and dilute the pptx-focused workflows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably verbose and padded: an 18-entry example color-palette catalog with hex codes, extensive "Visual Details Options" design menus that restate design knowledge Claude already has, an off-skill "Visual Enhancement with Scientific Schematics" section, a promotional "K-Dense Web" section, and heavy ALL-CAPS emphasis repetition ("CRITICAL/IMPORTANT/MANDATORY/NEVER" dozens of times). Not a 1 because the core workflow sections (OOXML editing, template replacement, thumbnails) are dense and largely free of explaining basics — a pptx-is-a-ZIP one-liner is genuinely useful — but the palette catalog and injected sections clearly pad the token budget. | 2 / 5 |
Actionability | Most guidance is executable: exact commands for markitdown, unpack/pack/validate, rearrange.py, inventory.py, replace.py, thumbnail.py, soffice/pdftoppm, plus a full annotated replacement-JSON example and real validation-error outputs. It is not a 5 because two MANDATORY entry-point resources ([html2pptx.md], [ooxml.md]) and scripts/generate_schematic.py are referenced but do not exist in the bundle, so a Claude following the creation/editing workflows literally would immediately hit missing files (only the unpack.py path gets a find fallback). | 4 / 5 |
Workflow Clarity | The editing workflow has an explicit validate-after-each-edit feedback loop ("Validate immediately after each edit and fix any validation errors before proceeding"), the creation workflow has a thumbnail visual-validation loop with named failure modes and "Repeat until all slides are visually correct", and the template workflow is a well-sequenced 7 steps with validation error examples. It falls short of 5 because the two principal workflows (create, edit) each begin with a mandatory read of a file (html2pptx.md, ooxml.md) that is absent from the bundle, and the off-skill schematics section inserts an unrelated sub-workflow into the creation path. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: the five scripts in scripts/ (html2pptx.js, inventory.py, rearrange.py, replace.py, thumbnail.py) are real and correctly referenced, but the two documented reference documents (html2pptx.md, ooxml.md) and the scientific-schematics resources do not exist, leaving the SKILL.md pointing at phantom files. Additionally, substantial content that clearly belongs in reference files — the ~90-line design/palette catalog and the detailed inventory-JSON schema documentation — is inlined in the body. Structure and section signaling exist, but the missing references and inlined bulk place this between the "references present but not clearly signaled / content should be separate" anchor and the good-structure anchor. | 3 / 5 |
Total | 13 / 20 Passed |