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 terse command-dispatch skill: executable safe-start commands, a complete one-line-per-command reference table, explicit safety rules for writes and deletes, and runtime `--help`/`schema` lookup instead of inlined flag documentation. The only meaningful gap is the absence of a worked example and a post-write verification step for its destructive operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: a two-line intro, three safe-start commands, six terse safety bullets, a one-line-per-command table, and a closing pointer to `--help` and `gog schema`. No concept explanations Claude already knows, no padding — every token earns its place. | 5 / 5 |
Actionability | Concrete, copy-paste commands are given ('gog auth list --check --json --no-input', 'gog schema slides --json', 'gog --readonly --account user@example.com slides --help') alongside a complete command table. Falls short of 5 because no worked example covers a common case (e.g. create-from-markdown or insert-text with real arguments) and the account placeholder must be substituted. | 4 / 5 |
Workflow Clarity | The 'Safe start' section sequences auth check -> schema -> readonly help, and explicit checkpoints exist ('--dry-run before supported writes', 'Confirm the exact account, object, and mutation before any write or delete'). Not 5: despite destructive commands (delete-slide, replace-slide), there is no post-write verification or error-recovery feedback loop. | 4 / 5 |
Progressive Disclosure | A compact (~57 line) body with well-organized sections, one clearly-signaled one-level reference ('Read `../gog/SKILL.md` first for shared auth, output, safety, and live-write rules'), and per-command detail delegated to runtime `--help`/`gog schema`. No bundle files exist, and the structure fits the simple-skill guidance for a 5. | 5 / 5 |
Total | 18 / 20 Passed |