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 body is highly actionable with well-sequenced, validation-backed workflows and executable commands across all four presentation tasks. Its main weaknesses are volume that could be tightened in the design-reference sections and broken reference paths where the deferred-to files (html2pptx.md, ooxml.md) and ooxml/scripts are missing from the bundle.
Suggestions
Include html2pptx.md and ooxml.md in the bundle (e.g., under references/) so the 'MANDATORY - READ ENTIRE FILE' links resolve, and pin the ooxml/scripts/* paths so the `find . -name unpack.py` fallback is unnecessary.
Trim the 18 color palettes to a smaller curated set and condense the Visual Details Options bullet lists to the highest-value patterns to reduce token overhead.
Remove or replace the generic 'Code Style Guidelines' section (e.g., 'Write concise code', 'Avoid verbose variable names') with PPTX-specific guidance Claude would not already know.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, actionable guidance (commands, JSON schemas, validation steps), but 18 full hex color palettes, lengthy Visual Details Options bullet lists, and a generic "Code Style Guidelines" section restate or pad content that could be trimmed without losing value. It sits below the efficient (4) anchor because these sections are noticeable rather than minor. | 3 / 5 |
Actionability | Provides fully executable, copy-paste-ready commands with arguments (markitdown, unpack.py, thumbnail.py, rearrange.py, inventory.py, replace.py, soffice, pdftoppm) plus complete JSON structure and replacement examples that cover the common creation, editing, and template cases. | 5 / 5 |
Workflow Clarity | Each of the three workflows is clearly sequenced with explicit validation checkpoints and feedback loops: the editing workflow mandates "Validate immediately after each edit and fix any validation errors before proceeding", the html2pptx workflow includes a visual-validation "Repeat until all slides are visually correct" loop, and the template workflow enforces shape-existence and overflow validation. | 5 / 5 |
Progressive Disclosure | References are clearly signaled and one level deep ("MANDATORY - READ ENTIRE FILE" for html2pptx.md and ooxml.md), but those referenced files are absent from the provided bundle, the ooxml/scripts/* paths do not resolve, and the unpack.py section relies on a `find . -name` workaround, so navigation breaks despite good signaling. | 3 / 5 |
Total | 16 / 20 Passed |