Content
77%Reviews 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 strong, validated workflows, but is weighed down by a heavy design-guidance section and dead references to editing.md/pptxgenjs.md that are absent from the bundle.
Suggestions
Either ship editing.md and pptxgenjs.md alongside SKILL.md or inline their essential content, since the body routes core tasks to files that don't exist in the bundle.
Trim the Design Ideas section (e.g., reduce the palette table and typography tables to a few examples) to lower token cost while preserving the core 'don't make boring slides' guidance.
Add an explicit validation checkpoint to the Editing Workflow steps (e.g., run scripts/office/validate.py after editing) to match the QA section's already-strong verification loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Commands and workflows are lean, but the Design Ideas section is voluminous (a 10-row palette table, typography tables, an extended Avoid list); while much of it is useful concrete guidance, it could be tightened and risks overloading the context window, fitting the 'mostly efficient but could be tightened' anchor. | 2 / 3 |
Actionability | It provides concrete, copy-paste-ready commands ('python -m markitdown presentation.pptx', 'python scripts/thumbnail.py', 'pdftoppm -jpeg -r 150 output.pdf slide', 'pip install "markitdown[pptx]"') plus a Quick Reference routing table, matching the fully-executable anchor. | 3 / 3 |
Workflow Clarity | The editing workflow is sequenced ('Analyze template -> Unpack -> manipulate slides -> edit content -> clean -> pack') and QA is an explicit fix-and-verify loop with a checkpoint ('Do not declare success until you've completed at least one fix-and-verify cycle'), matching the clear-sequence-with-validation anchor. | 3 / 3 |
Progressive Disclosure | The Quick Reference table signals one-level-deep pointers to [editing.md] and [pptxgenjs.md], but those files do not exist in the bundle (only SKILL.md and scripts/ are present), so the navigation is broken; this fits the 'references present but not clearly signaled/valid' band rather than the clean one-level-deep anchor. | 2 / 3 |
Total | 10 / 12 Passed |