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.
A well-structured, highly actionable command reference that assumes Claude's competence, held back by missing validation checkpoints on destructive/batch operations and the absence of any progressive file structure.
Suggestions
Add validation steps before destructive/batch operations — e.g. instruct running get-metadata to confirm a slide object ID before delete-slide, or preview replace-text matches before applying.
Confirm the referenced scripts (scripts/auth.py, scripts/slides.py) are actually bundled; if absent, either ship them or note where they live.
Consider moving the JSON output-format details and layout enumeration into a short reference file to lighten the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean command reference with brief inline comments and JSON output samples; the only redundancy is repeating the frontmatter description as the opening line. | 4 / 5 |
Actionability | Commands are fully executable and copy-paste ready (e.g. 'python scripts/slides.py get-text "1abc..."'), with examples covering get-text, find, create, add-slide, replace-text, delete-slide, and batch-update. | 5 / 5 |
Workflow Clarity | Setup and command groups are sequenced, but destructive ops (delete-slide) and batch ops (replace-text across all slides, batch-update) have no validation/verification checkpoints, capping this dimension at 3. | 3 / 5 |
Progressive Disclosure | Content is well-organized into clearly headed sections; however everything is inlined in SKILL.md with no bundle files (references/, scripts/, assets/ are absent), so there is no one-level-deep reference structure. | 4 / 5 |
Total | 16 / 20 Passed |