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: copy-paste safe-start commands, explicit safety gates for writes, a complete command overview, and disciplined deferral of syntax detail to --help and the machine-readable schema. Its only soft spots are the absence of a worked write-operation example and any error-recovery guidance when the auth check fails.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is entirely lean: three executable safe-start commands, five one-line safety rules, a compact command table, and a pointer to --help/schema. It never explains what Gmail is or how the tool works; every token earns its place, matching anchor 5. | 5 / 5 |
Actionability | The safe-start block ("gog auth list --check --json --no-input", "gog --readonly --account user@example.com gmail search 'newer_than:7d' --max 10 --json --wrap-untrusted") is copy-paste ready, and "Run `gog gmail <command> --help`" plus "gog schema gmail <command> --json" give exact paths to every command contract. The minor gap keeping it below anchor 5 is that no write operation (e.g. send or trash) has a worked example. | 4 / 5 |
Workflow Clarity | The safe start sequences validation-on-entry (auth "--check" -> schema -> readonly search) and the rules "use `--dry-run` before supported writes" and "Confirm the exact account, object, and mutation before any write or delete" supply checkpoints for the destructive and batch commands — so the ≤3 cap for missing validation does not apply. It sits below anchor 5 only because there is no error-recovery loop (e.g. what to do when the auth check fails). | 4 / 5 |
Progressive Disclosure | The body is ~55 lean, well-organized lines (Safe start, Commands) with no bundle files to split; its single reference — "Read `../gog/SKILL.md` first" — is one level deep and clearly signaled, and the command table defers per-command detail to `--help`/`schema`. This matches the simple-skill pattern that scores 5 on well-organized sections alone. | 5 / 5 |
Total | 18 / 20 Passed |