CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gogcli

Google Workspace CLI for agents. Use gog to access Gmail, Calendar, Drive, Contacts, Tasks, Sheets, Docs, Slides, Forms, Chat, and more. Triggers on: 'check my email', 'what's on my calendar', 'search gmail', 'list calendar events', 'send email', 'check tasks', 'search drive', 'list contacts', 'create event', 'upload to drive', 'read spreadsheet', or any Google Workspace task.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

83%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, highly actionable CLI quick reference that respects the context window and gives copy-paste commands across the whole Workspace surface. Its main weakness is the absence of validation checkpoints around its destructive/outward-facing operations (send, create, upload, sheet writes), which caps workflow clarity despite the good auth-verification and troubleshooting loops.

Suggestions

Add validation steps for destructive/outward-facing commands: e.g., after 'gog gmail send', fetch the message back or show a draft before sending; after 'gog calendar create', run 'gog calendar events primary --today --json' to confirm the event landed.

For 'gog drive upload' and 'gog sheets update', include a verify step (re-list or re-read the changed range) so failed writes are caught immediately.

Consider moving the per-service command catalogs (especially Gmail and Calendar) into a references/ file, keeping SKILL.md as an overview with common patterns — this would also improve progressive disclosure.

DimensionReasoningScore

Conciseness

The body is a lean command reference: no concept explanations, no library background, every line is either an executable command, a flag table, an env var, or an error-remedy pair ('"No auth for gmail"': Need 'gog auth add <email> --services gmail'). Matches anchor 5 — assumes Claude's competence and every token earns its place; there is no padding to trim for anchor 4's 'minor instances of over-explanation'.

5 / 5

Actionability

Every example is a copy-paste-ready, complete command with realistic arguments ('gog gmail send --to user@example.com --subject "Subject" --body "Body text"', 'gog sheets update <spreadsheetId> 'A1' 'val1|val2,val3|val4''), plus an output-mode table and jq pipelines covering the common cases. This is exactly anchor 5; not 4 because there are no gaps in the common cases and nothing is pseudocode.

5 / 5

Workflow Clarity

The rubric caps this at 3 for destructive or batch operations without validation, and the skill has several — 'gmail send', 'calendar create', 'drive upload', 'sheets update/append', 'chat dm send' — with no verify step (e.g., show the sent message or re-read the created event before/after). It sits above anchor 2's 'rough sequence, validation absent' because the auth flow does include an explicit checkpoint ('gog auth list --check') and the Troubleshooting section gives a fix-retry loop for errors, but the send/create/upload paths have no checkpoints at all.

3 / 5

Progressive Disclosure

Well-organized single-file structure with clear per-service sections, an output-mode table, and a Patterns section, all easy to navigate — matching anchor 4's 'good structure; most content appropriately placed'. Not 5: at ~170 lines the per-service command catalogs (Gmail and Calendar alone hold ~10 commands each) are exactly the bulk a references/ file could absorb, and the skill exceeds the under-50-line simple-skill case; not 3 because nothing is buried and the inline placement is defensible for a quick-reference CLI skill.

4 / 5

Total

17

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-crafted description: it states the niche clearly, enumerates the full service surface, and provides an explicit, natural-language trigger list. The only soft spot is that the capability sentence uses the generic verb 'access' (actions live in the trigger phrases instead) and trigger coverage skips Docs/Slides/Forms/Chat phrasings.

Suggestions

Replace the generic 'access' with two or three concrete verbs in the capability sentence (e.g., 'Search and read Gmail, create and list Calendar events, upload and search Drive files...').

Add trigger phrases for the uncovered services, e.g., 'read this doc', 'export slides', 'fill out a form', 'send a chat message'.

Consider dropping 'and more' — it is a mild over-claim that adds no trigger value.

DimensionReasoningScore

Specificity

The 'what' sentence enumerates every service ('Gmail, Calendar, Drive, Contacts, Tasks, Sheets, Docs, Slides, Forms, Chat, and more') but its main verb is the generic 'access'; concrete actions do appear via the trigger phrases ('send email', 'create event', 'upload to drive', 'read spreadsheet'). This fits anchor 4 — several specific actions with minor gaps — rather than 5, since the capability sentence itself leans on 'access' and 'and more' instead of listing actions, and clearly exceeds anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Explicitly answers both: 'Google Workspace CLI for agents. Use gog to access [services]' (what) and an explicit 'Triggers on:' clause with a dozen concrete trigger phrases (when). This matches anchor 5 exactly; it is not 4 because the 'when' guidance is explicit and phrase-level, not merely implied or generic.

5 / 5

Trigger Term Quality

Strong natural phrasing users would actually say ('check my email', "what's on my calendar", 'search gmail', 'list calendar events'), plus a catch-all 'any Google Workspace task'. Not 5 because natural variants for Docs, Slides, Forms, and Chat (e.g., 'write a doc', 'make a slide deck') are missing; comfortably above 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

Names a unique niche tool ('gog', Google Workspace CLI for agents) with service-specific triggers unlikely to fire for other skills; minimal overlap risk. Matches anchor 5; not 4 because it is more than 'mostly distinct' — the named CLI plus per-service triggers carve out a clear, non-overlapping niche.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

joelhooks/joelclaw

Path

skills/gogcli/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.