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 a model of a thin wrapper skill: a validated safe-start sequence, a precise command table, and disciplined deferral of detail to --help, the JSON schema, and the parent gog skill. The only gaps are the absence of a single worked example of an actual operation and of explicit error-recovery guidance after a failed check or dry-run.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every token earns its place: a short safe-start code block, five one-line bullets, a five-row command table, and a closing pointer to '--help' and 'gog schema ... --json'. It explains nothing Claude already knows and never pads. It clearly matches anchor 5 rather than 4, which would require some over-explanation to trim — none is present. | 5 / 5 |
Actionability | The safe-start block gives copy-paste-ready commands ('gog auth list --check --json --no-input', 'gog schema maps --json', 'gog --readonly --account user@example.com maps --help') and the table pairs each command with its purpose. It stops short of anchor 5 only because no example invocation of an actual operation is shown (e.g. 'gog maps geocode "1600 Amphitheatre Pkwy"'), leaving real-usage syntax to --help; this is 'mostly executable guidance ... with minor gaps' (4), not vague or pseudocode. | 4 / 5 |
Workflow Clarity | The 'Safe start' section gives a clear sequence (verify auth with '--check', read the schema, inspect help) plus explicit pre-write checkpoints: '--readonly' when mutation is forbidden, '--dry-run before supported writes', and 'Confirm the exact account, object, and mutation before any write or delete'. This matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'); it misses 5 because there is no error-recovery feedback loop (e.g. what to do when auth --check fails or a dry-run surfaces a problem) and post-write verification is only implied by the shared-rules pointer. | 4 / 5 |
Progressive Disclosure | At roughly 38 lines this is a simple skill with well-organized sections and no bundle files to disclose, so per the simple-skill scoring note it can score 5 on organization alone. It also pushes detail to clearly-signaled, one-level-deep surfaces: 'Read ../gog/SKILL.md first' for shared rules, 'gog maps <command> --help' and 'gog schema maps <command> --json' for per-command contracts — nothing that belongs in a separate file is inlined. | 5 / 5 |
Total | 18 / 20 Passed |