gmail

Interact with Gmail - search emails, read messages, send emails, create drafts, and manage labels. Use when user asks to: search email, read email, send email, create email draft, mark as read, archive email, star email, or manage Gmail labels. Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

76%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.

The content is highly actionable and token-efficient, with executable commands verified against the bundled scripts and a clean section structure. The main gap is the absence of validation/confirmation checkpoints around destructive send and batch label-modify operations, which caps workflow clarity.

Suggestions

Add an explicit confirmation/validation step before irreversible operations — e.g. echo the resolved recipients/subject before `send`, or require a `--confirm` flag, and verify a draft exists after `send-draft`.

Consider moving the Gmail Query Syntax and Common Label ID tables into references/ files (linked from SKILL.md) to slim the main body and push detail one level deep.

Trim redundant inline comments in code blocks (e.g. "# Mark as read (remove UNREAD label)") since the command flags are self-explanatory.

Dimension	Reasoning	Score
Conciseness	The body is lean — copy-pasteable commands with minimal prose and no explanations of what email/Gmail is — but a few inline comments ("# Mark as read (remove UNREAD label)") are mildly redundant and could be trimmed.	4 / 5
Actionability	Every operation is a fully executable CLI invocation with real flags that match scripts/gmail.py (verified --limit, --format, --to/--cc/--bcc, --html, --from, --add-label/--remove-label), copy-paste ready and covering common cases.	5 / 5
Workflow Clarity	Although well-organized for a simple CLI skill, sending emails and bulk label modifications are destructive/irreversible operations with no validation or confirmation checkpoint (e.g. verify recipient before send, confirm draft after send-draft), so workflow_clarity is capped at 3 per the destructive-operations rule.	3 / 5
Progressive Disclosure	A single well-organized SKILL.md with sections (Setup, Commands, Query Syntax, Label IDs, Token Mgmt) and real script paths; no nested references. The sizable query-syntax and label-ID tables could plausibly live in references/ but inlining is reasonable for this scope, so it sits just below a 5.	4 / 5
	Total	16 / 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 strong description: it names concrete Gmail capabilities, gives explicit natural-language trigger phrases, and clearly differentiates itself from the full Google Workspace MCP server. Only minor tightening of capability coverage and trigger synonyms would reach perfection.

Dimension	Reasoning	Score
Specificity	"search emails, read messages, send emails, create drafts, and manage labels" lists several concrete actions, but a few operations (star, archive, important) appear only in the trigger clause rather than the capability statement, leaving minor coverage gaps short of a 5.	4 / 5
Completeness	It explicitly answers "what" ("Interact with Gmail - search emails...manage labels") and "when" ("Use when user asks to: ...") with concrete trigger phrases, matching the highest anchor.	5 / 5
Trigger Term Quality	"search email, read email, send email, create email draft, mark as read, archive email, star email, manage Gmail labels" are natural phrases users would actually say, with good coverage; a few natural variations (e.g. "unread", "forward") are missing.	4 / 5
Distinctiveness Conflict Risk	"Gmail" plus Gmail-only triggers and "Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication" carve a clear niche with minimal overlap risk.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

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: sanjay3290/ai-skills
Path: skills/gmail/SKILL.md
Commit: 281d88d

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.