Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
59
48%
Does it follow best practices?
Impact
75%
2.27xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/gog/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies the tool and its supported Google Workspace services but fails to describe concrete actions or provide explicit trigger guidance. It reads more like a product tagline than a skill description that helps Claude decide when to use it. The listing of service names provides some keyword coverage but lacks action-oriented terms users would naturally use.
Suggestions
Add a 'Use when...' clause specifying trigger scenarios, e.g., 'Use when the user asks to send emails, manage calendar events, upload/download files from Drive, manage contacts, edit spreadsheets, or work with Google Docs.'
List concrete actions for each service, e.g., 'Send and read Gmail messages, create and manage Calendar events, upload and share Drive files, edit Sheets and Docs.'
Include common natural language variations users might say, such as 'schedule a meeting', 'check my email', 'share a file', 'Google Drive', 'Google Sheets'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Google Workspace CLI) and lists the specific services (Gmail, Calendar, Drive, Contacts, Sheets, Docs), but does not describe concrete actions like 'send emails', 'create events', 'upload files', etc. | 2 / 3 |
Completeness | Describes what it is (a Google Workspace CLI tool covering several services) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing 'Use when' caps completeness at 2, and the 'what' is also weak (no actions described), so this scores a 1. | 1 / 3 |
Trigger Term Quality | Includes good product-name keywords (Gmail, Calendar, Drive, Sheets, Docs, Google Workspace) that users would naturally mention, but misses common action-oriented terms like 'send email', 'schedule meeting', 'upload file', 'create spreadsheet', or variations like 'Google Drive', 'Google Docs'. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'Google Workspace CLI' and specific service names provides some distinctiveness, but the breadth of six different services without specific actions could overlap with individual skills for email, calendar, file management, or spreadsheets. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid CLI reference skill with excellent actionability—nearly every command is concrete and copy-paste ready. Its main weaknesses are moderate verbosity (calendar color hex codes, HTML tag explanations Claude already knows) and a flat structure that could benefit from splitting detailed reference material into separate files. Adding explicit validation steps for destructive operations (sending emails, modifying sheets) would strengthen workflow clarity.
Suggestions
Remove the calendar color hex code listing—the command `gog calendar colors` already provides this; just reference the command.
Remove the HTML tag explanations (p, br, strong, etc.)—Claude already knows HTML; the example alone is sufficient.
Add an explicit confirmation/validation step before destructive operations like sending emails or clearing sheets (e.g., 'Use --dry-run or preview before sending').
Consider moving the detailed email formatting examples and calendar colors into a separate reference file to keep the main skill concise.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands, but the calendar colors section listing all 11 hex codes is unnecessary padding—Claude could retrieve them via the command itself. The email formatting section also over-explains HTML tags Claude already knows. | 2 / 3 |
Actionability | Excellent actionability throughout—every command is copy-paste ready with concrete flags, arguments, and realistic examples. The heredoc stdin example and sheets JSON examples are particularly well done. | 3 / 3 |
Workflow Clarity | Setup is clearly sequenced (auth credentials → auth add → auth list), and the notes section includes a confirmation step for destructive actions. However, there's no explicit validation/error recovery for operations like sending mail or modifying sheets, and the overall structure is more of a reference list than a guided workflow. | 2 / 3 |
Progressive Disclosure | Content is organized into logical sections (setup, common commands, colors, email formatting, notes), but everything is inline in one file. The calendar colors table and detailed email formatting examples could be split into referenced files to keep the main skill leaner. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
4467e04
Table of Contents
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.