Content
77%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 well-sequenced, highly actionable instruction set with explicit validation checkpoints, a feedback rule for overflow, and a deliverable checklist — genuinely strong workflow clarity. Its main defects are a broken reference to a nonexistent STYLE_PRESETS.md that the core CSS base depends on, and unreferenced bundle scripts that hurt navigation, plus minor token redundancy across sections.
Suggestions
Create STYLE_PRESETS.md (or inline the mandatory viewport-safe CSS block directly into SKILL.md) — the body twice directs the reader to a file that is not in the bundle, breaking the skill's core implementation guidance.
Reference the existing bundle scripts in the body (e.g., use scripts/extract-pptx.py in the PPT/PPTX Conversion section and scripts/export-pdf.sh in the Deliver step) so provided tooling is discoverable.
Consolidate the viewport-fit rules, which currently appear in Non-Negotiables, Workflow step 5, Anti-Patterns, and the Deliverable Checklist, into a single authoritative section to trim tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight, decision-dense prose (non-negotiables, a numeric density-limit table, anti-patterns) that assumes Claude's competence, matching anchor 4. It is not anchor 5 because of minor trims available: viewport-fit rules repeat across four sections, a credit line about @zarazhangrui adds little actionable value, and bullets like "keep contrast readable" state knowledge Claude already has. | 4 / 5 |
Actionability | Guidance is largely executable and specific: exact CSS rules ("height: 100vh; height: 100dvh; overflow: hidden;"), clamp() scaling, five concrete validation viewport sizes, OS-specific opener commands, and the python-pptx tool choice — matching anchor 4 for mostly executable guidance with minor gaps. It misses anchor 5 because the core implementation artifact (the mandatory viewport-safe CSS block) is delegated to STYLE_PRESETS.md rather than shown, and no runnable code sample exists. | 4 / 5 |
Workflow Clarity | The 7-step workflow (detect mode, discover content, discover style, build, enforce viewport fit, validate, deliver) is clearly sequenced with an explicit validation step listing concrete sizes and browser-automation checks, an error-recovery directive ("when content does not fit, split into multiple slides"), a fallback when python-pptx is unavailable, and a final Deliverable Checklist. This matches anchor 5: explicit validation steps, feedback for error recovery, and a checklist. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: the body references `STYLE_PRESETS.md` twice ("read STYLE_PRESETS.md for the viewport-safe CSS base", "Use the density limits and mandatory CSS block in STYLE_PRESETS.md") but that file does not exist in the bundle, and the two bundle scripts (scripts/extract-pptx.py, scripts/export-pdf.sh) are never referenced from the body, leaving them undiscoverable. Section structure in the body itself is good and references are clearly signaled, which keeps this above anchor 2, but broken references and orphaned bundle files are more than the 'minor organization gaps' of anchor 4. | 3 / 5 |
Total | 16 / 20 Passed |