Content
75%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 efficient, actionable command reference with a sound safe-start pre-flight and explicit validation guidance for destructive operations. Its main weakness is the large inlined command table, which leans on reference material that could be deferred to schema/--help.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no concept explanations), with a useful command catalog; the 40-row table partly duplicates what `--help`/`schema` provide, a minor trimmable excess, matching the 'Efficient; minor instances of over-explanation' anchor. | 4 / 5 |
Actionability | The Safe start provides copy-paste executable commands and the closing guidance points to `--help`/`schema` for the rest; concrete coverage of the common read case with minor gaps for write commands matches anchor 4. | 4 / 5 |
Workflow Clarity | A pre-flight sequence (auth check, schema, readonly get) plus explicit checkpoints (`--readonly`, `--dry-run`, 'confirm the exact account, object, and mutation before any write or delete') supply validation for the destructive/batch operations, so the destructive-cap does not apply and this sits at anchor 4. | 4 / 5 |
Progressive Disclosure | A clearly signaled one-level pointer to `../gog/SKILL.md` and well-organized sections (Safe start, Commands) give good structure; the inlined full command catalog is a minor organization gap, matching anchor 4. | 4 / 5 |
Total | 16 / 20 Passed |