Content
68%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 highly actionable, well-sequenced skill with concrete scripts and a hard viewport-validation gate, but it leans verbose on CLI flag listings and critically depends on STYLE_PRESETS.md which is missing from the bundle, breaking progressive disclosure.
Suggestions
Include the missing STYLE_PRESETS.md referenced file (or inline its essential CSS/density/preset content) so the overview's one-level-deep references resolve.
Consolidate the html_to_longimage.py and html_to_pptx.py CLI flag tables and typical-usage blocks to reduce repetition and save tokens.
Add an explicit validate→fix→retry feedback loop for the on-demand PPTX conversion step to complete the workflow checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with actionable structure, but the full CLI flag lists for html_to_longimage.py and html_to_pptx.py are repeated/verbose, the typical-usage bash blocks restate capabilities already described, and the density table/anti-patterns duplicate concepts that could be tightened. | 3 / 5 |
Actionability | Provides copy-paste-ready commands for all three scripts with concrete flags, JSON output specs, multiple worked usage examples, and explicit dependency/install hints; execution path is unambiguous. | 5 / 5 |
Workflow Clarity | The seven-step workflow is clearly sequenced with a final delivery checklist, and viewport-fit is treated as a hard validation gate; however the PPTX-conversion path is on-demand without an explicit validate-then-retry feedback loop, leaving a minor checkpoint gap. | 4 / 5 |
Progressive Disclosure | The body repeatedly references STYLE_PRESETS.md (4+ times) as the source of essential CSS, density limits, and presets, but that file is not present in the bundle; the overview depends on an external file that doesn't exist and isn't clearly signaled as a real one-level-deep reference, making navigation broken. | 2 / 5 |
Total | 14 / 20 Passed |