Content
82%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.
A well-structured command-reference skill: highly executable, lean, with proper overview-plus-references layering and genuine safety and error-handling guidance. The main improvement opportunities are de-duplicating the Quick Reference, surfacing the orphaned permissions.md, and making dry-run validation an explicit step before destructive operations.
Suggestions
Cut or merge the Quick Reference section with the per-service Commands sections (and the duplicated freebusy example) to remove repeated tokens; prefer the dynamic date pattern already shown in Examples over hardcoded demo dates like 2026-06-25.
Link references/permissions.md from SKILL.md (e.g., in the Agent Safety section: 'See [permissions.md](references/permissions.md) for the read/write classification of every command') so the safety classification is discoverable.
Add explicit validation sequencing for destructive and batch operations, e.g., instruct running `gog --dry-run drive delete <fileId>` and confirming the preview before executing, and resolving the exit-4 guidance (`gog auth setup`) with the documented `gog auth add` / `gog auth doctor` flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by terse, executable command blocks with no explanation of concepts Claude already knows, so it is well past anchor 3. It stops short of anchor 5 ("every token earns its place") because the Quick Reference repeats six commands that reappear verbatim in the Commands sections, the freebusy example appears twice, and fixed demo dates ("2026-06-25") are repeated where the dynamic `date -d '+1 day'` pattern shown in Examples would serve better. | 4 / 5 |
Actionability | Nearly everything is copy-paste-ready: real command syntax with concrete flags per service, an exit-code table with retry classifications, safety flags (--readonly, --dry-run, --no-input), and worked examples (search+jq pipeline, dynamic-date event creation) covering the common cases. The only placeholders are inherently session-specific IDs (<messageId>, <docId>), which matches anchor 5 rather than anchor 4's "minor gaps". | 5 / 5 |
Workflow Clarity | The setup sequence is clear and ordered (install → auth credentials → authorize per-service → verify with `gog auth doctor`), error recovery guidance is explicit (retryable vs. user-intervention exit codes), and destructive operations have a documented validation mechanism (`--dry-run drive delete`, `--readonly`). It is not anchor 5 because the destructive commands are listed without an explicit dry-run-first instruction and the batch download example has no validation checkpoint — validation exists but is implicit rather than sequenced into the workflows. | 4 / 5 |
Progressive Disclosure | The overview is well organized with per-service command samples and clearly signaled one-level-deep links ("See [gmail.md](references/gmail.md) for the full command reference"), and the docs.md → docs-workflows.md link is also surfaced directly from SKILL.md so nothing is buried. It falls short of anchor 5 because references/permissions.md — a useful read/write safety classification — exists in the bundle but is not linked from SKILL.md or any other file, making it undiscoverable. | 4 / 5 |
Total | 17 / 20 Passed |