Content
57%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized instruction skill that assumes competence and uses real, one-level-deep bundle references effectively. It loses points on actionability (no executable code) and workflow clarity (validation checkpoints implicit for the build/render steps), and some prose could be tighter.
Suggestions
Tighten the dense run-on sentences in the Overview and Figure Packaging Rule 3 into shorter bullets to improve conciseness.
Add at least one minimal executable snippet (e.g. a Playwright/Puppeteer HTML-to-PDF render call or a pptxgenjs slide-asset placement) to lift actionability.
Insert an explicit validate-then-proceed checkpoint in the PDF/slide build steps (e.g. 'render, verify the output opens and figures placed, then export') to strengthen workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and assumes Claude's competence (no explanation of what a PDF is or how libraries work), but the Overview prose paragraphs and Figure Packaging Rule 3 are dense run-on sentences that could be tightened. Not score 3 because those passages pad rather than earn every token; not score 1 because there is no conceptual over-explanation. | 2 / 3 |
Actionability | Concrete tools are named (pptxgenjs, pdf-lib, PDFKit, jsPDF, Playwright, Puppeteer, Google Slides API) and export formats are specified (SVG/PNG/PDF), but there is no executable code and guidance stays at the direction level. Not score 3 because nothing is copy-paste ready; not score 1 because specific libraries and formats make it more than abstract description. | 2 / 3 |
Workflow Clarity | Figure Packaging Rules form a numbered sequence and Rule 3 includes an explicit approval feedback loop ('repeat the concise bullet review until the user agrees') with editorial QA, but there is no strict validate→fix→retry checkpoint for the document/PDF generation steps. Not score 3 because validation checkpoints are implicit rather than enforced for the build/render operations; not score 1 because sequencing and one feedback loop are present. | 2 / 3 |
Progressive Disclosure | SKILL.md is a clear overview that points to one-level-deep references, and all four referenced bundle files (./references/report-structure-and-figure-packaging.md, pdf-generation-paths.md, powerpoint-and-google-slides.md, document-embedding-and-regeneration.md) exist on disk and are signaled in the References section. Not score 2 because the split is clean and navigation is explicit. | 3 / 3 |
Total | 9 / 12 Passed |