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 a tight, well-structured command reference with executable safe-start commands and clear safety guidance, and it correctly delegates shared rules to ../gog/SKILL.md. Its main weakness is the absence of an explicit validation feedback loop for the destructive slide operations it exposes.
Suggestions
Add a short validation checkpoint for destructive commands, e.g. run `--dry-run` then verify the target object ID with `gog slides info` before applying delete/replace operations.
Provide one concrete example invocation for the most common commands (e.g. create, export, insert-image) to lift actionability from 4 to 5.
Consider moving the 25-row command table into a references file (e.g. COMMANDS.md) with a concise overview inline, to tighten progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no re-explanation of concepts Claude already knows: a compact safe-start block, a one-line-per-command table, and terse guidance, where every section earns its place; not below 5 because there is no padding to trim. | 5 / 5 |
Actionability | Safe-start gives copy-paste commands (auth list, schema, readonly help) and the body directs to `gog slides <command> --help` and `gog schema slides <command> --json`; it is a 4 rather than 5 because the 25 command rows list purposes but no concrete example invocations for common cases. | 4 / 5 |
Workflow Clarity | A safe-start sequence and safety bullets (--dry-run, --readonly, confirm-before-write) exist, but the skill exposes destructive commands (delete-slide, replace-slide, replace-text) without an explicit validate->fix->retry feedback loop, so the rubric's destructive-operations cap holds it at 3; not a 4 because verification checkpoints are absent. | 3 / 5 |
Progressive Disclosure | Clear sections (Safe start, Commands) and one clearly signaled one-level reference to `../gog/SKILL.md` for shared rules, with no bundle files present; a 4 rather than 5 because the 25-row command table is inline bulk that, while reasonable as an overview, leaves minor organization gaps. | 4 / 5 |
Total | 16 / 20 Passed |