Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, actionable skill with clear workflows and good progressive disclosure. The main weakness is some redundancy in the examples section, where three similar workflows could be consolidated into fewer, more differentiated examples. Overall, it provides strong executable guidance with appropriate verification steps and error handling.
Suggestions
Consolidate the three examples into one comprehensive example and one shorter variant, as they follow nearly identical patterns (create → get → insert text → verify) with minimal differentiation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but has some redundancy. The three examples are quite similar (create presentation, add slides, insert text, verify) and could be consolidated. The troubleshooting section and some setup verification details add moderate bloat, though most content earns its place. | 2 / 3 |
Actionability | Provides fully executable bash commands with concrete arguments, coordinate values, and clear flag usage. The command reference is comprehensive and copy-paste ready, with specific examples showing real workflows including presentation creation, text insertion, image placement, and shape creation. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit verification checkpoints after each major operation (e.g., 'Verify creation and get the default slide ID', 'Verify content was inserted correctly'). Error handling distinguishes retryable vs non-retryable errors with clear guidance on when to stop and inform the user. | 3 / 3 |
Progressive Disclosure | Well-structured with clear navigation: quick start in the main file, detailed references linked one level deep (permissions.md, command-reference.md, layouts-guide.md, shapes-guide.md), and external documentation links for OAuth setup and API docs. Content is appropriately split between overview and reference material. | 3 / 3 |
Total | 11 / 12 Passed |