Content
46%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 split-quality body: the front half (When to Use, Dependencies, Example Usage, Implementation Details) is concrete and executable, but the back half is generic template filler, the only validation command is broken, and none of the real bundle scripts are surfaced. The skill advertises capabilities (thumbnails, PDF export, template support) whose actual tooling exists in the bundle yet is never linked.
Suggestions
Replace the generic boilerplate tail (When Not to Use, Required Inputs, Recommended Workflow, Deterministic Output Rules, Output Contract, Validation and Safety Rules, Failure Handling, Completion Checklist, Scope Reminder) with pptx-specific guidance or remove it entirely — these sections add tokens without adding anything Claude does not already know.
Surface the actual bundle scripts with one-line usage examples (e.g., `python scripts/office/unpack.py input.pptx`, `python scripts/office/validate.py unpacked/`, `python scripts/thumbnail.py input.pptx`), and fix the Quick Validation section — `scripts/__init__.py` is an empty file, so `python scripts/__init__.py --help` cannot produce the documented expected output.
Add an executable command for the advertised export features (e.g., the LibreOffice headless PPTX-to-PDF invocation) instead of only noting that 'export generally requires external rendering'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly half the body is generic boilerplate unrelated to pptx specifics: "A clearly specified task goal aligned with the documented scope", "Keep output safe, reproducible, and within the documented scope at all times", and a "Scope Reminder" that repeats the frontmatter description verbatim. This matches 'Noticeably verbose; several unnecessary explanations or padded sections'; it is not 1 because the technical sections (Example Usage, Implementation Details) are reasonably tight and free of beginner-concept explanations. | 2 / 5 |
Actionability | The Example Usage section is complete, executable, copy-paste-ready code covering creation (prs.slide_layouts[0]), text editing via TextFrame, image insertion with Pillow normalization, and title extraction, with concrete details like "prs.slide_layouts[0] for title slide". It is not 5 because the advertised export features have no commands ("Thumbnail/PDF export generally requires external rendering") and the Quick Validation command `python scripts/__init__.py --help` targets an empty 0-byte file and cannot produce the stated expected output; it is not 3 because the core create/edit/extract path is fully runnable with real code, not pseudocode. | 4 / 5 |
Workflow Clarity | "Recommended Workflow" lists a sequence ("Validate the request against the skill boundary... Run a final validation pass") but all steps are abstract with no concrete checkpoints — matching 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'. It is not 4 because the only validation command is broken (empty scripts/__init__.py) and no step includes an executable checkpoint or feedback loop; it is not 2 because a coherent sequence plus dedicated Failure Handling and Completion Checklist sections do exist. | 3 / 5 |
Progressive Disclosure | The bundle provides substantial tooling (scripts/add_slide.py, clean.py, thumbnail.py, and scripts/office/ with unpack.py, pack.py, validate.py, soffice.py) but the body never references any of them; the sole reference, "python scripts/__init__.py --help", points to an empty file. This matches 'Minimal structure; content that clearly belongs in separate files is inlined; or references are buried' — the OOXML editing/export workflows that live in the bundle are invisible from SKILL.md. It is not 3 because there is effectively no working navigation to the bundle at all, and not 1 because the body itself is well sectioned rather than an unstructured wall of text. | 2 / 5 |
Total | 11 / 20 Passed |