Content
76%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 lean, well-organized, and highly actionable, with concrete commands for every operation and clear output documentation. The main gaps are the absence of validation/verification steps for the destructive and batch operations, and the referenced scripts not being present in the bundle to confirm executability.
Suggestions
Add verification checkpoints for risky operations: after replace-text or batch-update, instruct to re-run get-text to confirm the change; before delete-slide, instruct to run get-metadata and confirm the slide ID.
Ship the referenced scripts (scripts/auth.py, scripts/slides.py) in the bundle, or note where they come from, so the documented commands are actually executable.
Consider moving the JSON output-format examples for find and get-metadata into a short reference file, keeping SKILL.md focused on the command catalog.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is pure operational content — setup commands, read/write command examples, a layout catalog, ID format notes, and token storage specifics — with no explanation of concepts Claude already knows. The only trimmable token is the opening line, which repeats the frontmatter description verbatim; that is not enough to drop below anchor 5 ('Lean and efficient; every token earns its place'). | 5 / 5 |
Actionability | Every operation has a copy-paste-ready command with realistic arguments and flags, and output formats are shown as concrete JSON — this approaches anchor 5. It scores 4 rather than 5 because the referenced files (scripts/auth.py, scripts/slides.py) are not present in the bundle, so the commands as shipped cannot actually be executed, and there are no examples of reading/validating output before or after batch-update. | 4 / 5 |
Workflow Clarity | The setup-then-use sequence is clear (login via scripts/auth.py, commands auto-authenticate), and delete-slide has a soft checkpoint ('use get-metadata to find IDs'). However destructive and batch operations (delete-slide, replace-text, batch-update) have no validation or verification steps — e.g. no 'run get-text to confirm the replacement' — which caps workflow clarity at 3 per the rubric's destructive/batch guideline. | 3 / 5 |
Progressive Disclosure | A single well-sectioned file with clear headers (setup, read, write, layouts, ID format, output, tokens) and no nested references, which suits a skill of this size. It is not 5 because the inline JSON output examples and full layout catalog could live in a reference file, and the body references scripts/ paths without the bundle providing those files to verify structure against. | 4 / 5 |
Total | 16 / 20 Passed |