gmail
Send, search, and organize Gmail messages, drafts, and labels. Use when asked to compose an email, reply to mail, forward a message, search inbox, manage attachments, or organize Gmail.
92
Does it follow best practices?
Evaluation — 91%
↑ 1.51xAgent success when using this skill
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that follows best practices. It uses third person voice, lists specific capabilities, includes a comprehensive 'Use when...' clause with natural trigger terms, and is clearly scoped to Gmail operations. The description provides sufficient detail for Claude to confidently select this skill when users mention email-related tasks.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Send, search, and organize Gmail messages, drafts, and labels' covers distinct operations with specific Gmail objects (messages, drafts, labels). | 3 / 3 |
Completeness | Clearly answers both what ('Send, search, and organize Gmail messages, drafts, and labels') AND when with explicit 'Use when...' clause listing specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'compose an email', 'reply to mail', 'forward a message', 'search inbox', 'manage attachments', 'organize Gmail' - these are all phrases users naturally use when requesting email help. | 3 / 3 |
Distinctiveness Conflict Risk | Clearly scoped to Gmail specifically, with distinct triggers like 'Gmail', 'inbox', 'email', 'mail' that distinguish it from other document or communication skills. Unlikely to conflict with non-email skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent actionability and clear workflow guidance. The command reference is comprehensive with executable examples throughout. Minor verbosity issues exist with some duplicated content (check command explanation, search syntax table that duplicates the referenced file), but overall the skill is effective and well-organized.
Suggestions
Remove the inline Gmail Search Query Syntax table since it duplicates content from the referenced gmail-queries.md - just keep the reference link
Consolidate the 'check' command explanation which appears in both Setup Verification and Commands sections
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundancy - the 'check' command is explained multiple times, and the Gmail search query syntax table duplicates content that's already referenced in gmail-queries.md. Some sections could be tightened. | 2 / 3 |
Actionability | Excellent actionability with fully executable bash commands throughout, complete with all required arguments clearly documented. Every command includes copy-paste ready examples with realistic placeholder values. | 3 / 3 |
Workflow Clarity | Clear multi-step workflows are provided (e.g., create draft → list drafts → send draft). The error handling section explicitly distinguishes retryable vs non-retryable errors with clear guidance to stop and inform the user for auth errors. | 3 / 3 |
Progressive Disclosure | Well-structured with clear navigation - quick start at top, detailed command reference in middle, and appropriate references to external docs (GCP setup, OAuth setup, gmail-queries.md) that are one level deep and clearly signaled. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- 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.