Content
90%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-engineered tool-router skill: lean tables, fully executable commands, clearly sequenced workflows with verification in the mutating document/spreadsheet cases, and proper splitting of parameter detail into one-level-deep reference files. The only notable gaps are a missing post-share verification step in the file-sharing workflow and an orphaned bundle file (docs-layout-workflow.md) that is not reachable from the main skill file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense task-to-tool routing tables with no concept explanations — it assumes Claude already knows what Gmail or Google Docs are — and every operational detail earns its place (e.g. 'Never use `uvx workspace-cli`: an unrelated, abandoned PyPI package squats that name'). Nothing is padded and nothing needs trimming, matching the lean anchor 5 rather than anchor 4. | 5 / 5 |
Actionability | Guidance is fully executable: exact tool names for every task, concrete CLI commands with a JSON argument example ("pass lists and objects as JSON (e.g. `label_ids='[\"INBOX\"]'`)"), specific env vars and paths, and a section anchor link (references/server-options.md#start_google_auth). Workflows cover the common cases with named tools and parameter-level tips like 'omit reply headers to target the latest non-draft, non-trash message'. | 5 / 5 |
Workflow Clarity | Six workflows are clearly sequenced with exact tool calls, and three include explicit verification steps ('read_sheet_values -- verify the update', 'get_doc_as_markdown -- verify the result') plus a credential-error recovery loop in First-Time Setup. It falls short of anchor 5 because 'Find and share a file' performs an outward-facing permission change with no post-share verification even though get_drive_file_permissions and check_drive_file_public_access are documented in the same skill. | 4 / 5 |
Progressive Disclosure | Excellent router structure: per-service tables in the body with clearly signaled one-level-deep parameter references ('For parameters: [references/gmail.md]') keeping ~2,600 lines of detail out of SKILL.md. However, the bundle file references/docs-layout-workflow.md (175 lines of doc-creation layout guidance) is never linked from SKILL.md or any other reference, making it undiscoverable — a minor organization gap that keeps this below anchor 5. | 4 / 5 |
Total | 18 / 20 Passed |