Content
93%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.
An exemplary lean command-reference skill: executable safe-start commands, a complete command table, explicit write-safety rules, and detail correctly deferred to --help/schema rather than bundled. The only gap is the lack of an explicit post-write verification or error-recovery step in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is a command, flag, or safety rule; there is zero padding or explanation of concepts Claude already knows (no 'what Google Calendar is' prose). The 28-row command table is dense reference, not verbosity — matches 'every token earns its place'. | 5 / 5 |
Actionability | The 'Safe start' block is copy-paste-ready with exact flags (--json --wrap-untrusted, --readonly, --no-input), and 'Run gog calendar <command> --help ... gog schema calendar <command> --json' plus 'Do not guess command syntax' gives a deterministic way to obtain exact executable syntax for every listed command. This discovery-based pattern covers the common cases as fully as inlined examples would. | 5 / 5 |
Workflow Clarity | The safe-start sequence (auth check → schema → readonly read) and safety bullets (--dry-run before writes, 'Confirm the exact account, object, and mutation before any write or delete') provide the key checkpoints for destructive operations, so the destructive-cap applies neither. It falls short of 5 only because there is no post-write verification or error-recovery loop (e.g. re-reading an event after create). | 4 / 5 |
Progressive Disclosure | Clean overview structure: the only file reference is the clearly signaled, one-level-deep 'Read ../gog/SKILL.md first', and per-command detail is delegated to --help/schema rather than inlined. Sections are well organized and the skill needs no bundle files — matching the under-50-lines exception for well-organized single-purpose skills. | 5 / 5 |
Total | 19 / 20 Passed |