Content
86%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 an exemplary lean CLI-wrapper skill: executable safe-start commands, explicit safety gates before any write, a compact command inventory, and clean delegation of flag detail to --help and the machine-readable schema. The only meaningful gap is the absence of a concrete example for write commands and any post-write verification or error-recovery guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~35 lines with zero concept explanations or padding: a one-line purpose, a delegated pointer for shared rules, an executable safe-start block, a compact command table, and pointers to --help and the schema contract. Every token earns its place, matching anchor 5. | 5 / 5 |
Actionability | The safe-start block is fully executable and copy-paste ready (auth check, schema fetch, a read-only search example), and the body directs to `gog contacts <command> --help` and `gog schema contacts <command> --json` for exact syntax. It stops short of anchor 5 because no example invocation exists for any write command (create/update/delete/batch), leaving the most common mutation cases without a concrete example. | 4 / 5 |
Workflow Clarity | Despite destructive and batch operations being present, the required validation checkpoints exist ('--dry-run before supported writes', 'Confirm the exact account, object, and mutation before any write or delete', '--readonly', and an auth/schema check before any operation), so the batch/destructive cap at 3 does not apply. It remains at anchor 4 rather than 5 because there is no post-write verification step or error-recovery loop (what to do when a command fails). | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, cleanly sectioned (Safe start, Commands), and correctly delegates bulk detail: shared auth/safety rules to the one-level-deep `../gog/SKILL.md` reference and per-command flag contracts to `gog schema contacts <command> --json` instead of inlining an API reference. Per the simple-skill guideline, this scores 5 with well-organized sections and no unnecessary external reference files. | 5 / 5 |
Total | 18 / 20 Passed |