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-executed operational skill: fully executable, verified commands with a clear multi-account model, an explicit auth-failure playbook with feedback loops, and honest documentation that matches the actual bundle scripts. Remaining polish is structural — consolidate the repeated 'auth.js accounts' guidance and overlapping agent rules, and consider moving the Gmail pagination example to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: no explanation of what Google Workspace or OAuth is, and every section is commands or terse rules. Not score 5 because of structural redundancy — 'node scripts/auth.js accounts' appears four times (lines 26, 77, 134, plus Agent guidance) and Agent guidance items 5-7 substantially repeat the 'Unauthorized/account-switch playbook' that follows; not score 3 because there is no padded or over-explained content, only minor trimming opportunities. | 4 / 5 |
Actionability | Everything is copy-paste executable: exact CLI invocations with heredocs ('node scripts/workspace.js exec --email user@example.com <<JS'), flags with defaults ('--timeout <ms>' default 30000, max 300000), the exec sandbox's exposed API surface, and a complete pagination example. Verified against the bundle: scripts/auth.js implements login/status/clear/accounts and scripts/workspace.js implements exec with --script/--timeout/--scopes and whoAmI, exactly as documented; the examples cover the common cases. | 5 / 5 |
Workflow Clarity | The unauthorized playbook is a numbered sequence with a feedback loop (enumerate profiles → retry with intended account → re-login if stale → retry original), and whoAmI serves as an explicit account-verification checkpoint. Not score 5 because the main flow is scattered across sections — Setup + auth appears last, after Usage, so the login-first dependency is implicit rather than a single ordered sequence; not score 3 because error-recovery checkpoints are explicitly present. | 4 / 5 |
Progressive Disclosure | A 'Files' section lists the two bundle scripts with one-line descriptions and every path referenced in the body (scripts/auth.js, scripts/workspace.js) is a real file — implementation detail lives in the scripts, one level deep. Not score 5 because at ~135 lines some content could move out of SKILL.md (the ~20-line Gmail trash-counting example would fit an examples reference, and common.js exists in the bundle but is undocumented); not score 3 because the structure is clean, sectioned, and nothing that clearly belongs in a separate file is inlined. | 4 / 5 |
Total | 17 / 20 Passed |