Agent skill

Gmail Skill

by benchflow-ai in benchflow-ai/skillsbench

Manage Gmail - send, read, search emails, manage labels and drafts.

Apache-2.0Auto-check passedProductivity & Automation

Install Gmail Skill

skills CLI

$ npx skills add benchflow-ai/skillsbench --skill gmail-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install benchflow-ai/skillsbench gmail-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/benchflow-ai/skillsbench.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill .claude/skills/gmail-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "gmail-skill" agent skill from https://github.com/benchflow-ai/skillsbench/tree/main/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill into .claude/skills/gmail-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail-skill", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/benchflow-ai/skillsbench/tree/main/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add benchflow-ai/skillsbench --skill gmail-skill -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install benchflow-ai/skillsbench gmail-skill --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/benchflow-ai/skillsbench.git skills-src && mkdir -p .agents/skills && cp -r skills-src/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill .agents/skills/gmail-skill && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "gmail-skill" agent skill from https://github.com/benchflow-ai/skillsbench/tree/main/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill into .agents/skills/gmail-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail-skill", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add benchflow-ai/skillsbench --skill gmail-skill -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install benchflow-ai/skillsbench gmail-skill --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/benchflow-ai/skillsbench.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill .cursor/skills/gmail-skill && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "gmail-skill" agent skill from https://github.com/benchflow-ai/skillsbench/tree/main/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill into .cursor/skills/gmail-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail-skill", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/benchflow-ai/skillsbench.git --path tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add benchflow-ai/skillsbench --skill gmail-skill -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install benchflow-ai/skillsbench gmail-skill --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/benchflow-ai/skillsbench.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill .gemini/skills/gmail-skill && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "gmail-skill" agent skill from https://github.com/benchflow-ai/skillsbench/tree/main/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill into .gemini/skills/gmail-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail-skill", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install benchflow-ai/skillsbench gmail-skill

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add benchflow-ai/skillsbench --skill gmail-skill -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/benchflow-ai/skillsbench.git skills-src && mkdir -p .github/skills && cp -r skills-src/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill .github/skills/gmail-skill && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "gmail-skill" agent skill from https://github.com/benchflow-ai/skillsbench/tree/main/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill into .github/skills/gmail-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail-skill", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add benchflow-ai/skillsbench --skill gmail-skill -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install benchflow-ai/skillsbench gmail-skill --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/benchflow-ai/skillsbench.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill .opencode/skills/gmail-skill && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "gmail-skill" agent skill from https://github.com/benchflow-ai/skillsbench/tree/main/tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill into .opencode/skills/gmail-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail-skill", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: gmail-skill
GitHub stars: 1.8k
Token cost: ~1.1k tokens
SKILL.md length: 305 words
Files: 18 (incl. scripts)
Skills in repo: 180
Repo updated: Jul 23, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Manage Gmail - send, read, search emails, manage labels and drafts.

Works in 4 steps: Read Documentation On-Demand → Execute Scripts via Bash → Parse JSON Output → …
User wants to interact with their Gmail account for email operations
SKILL.md covers First-Time Setup, Multi-Account Support, Usage Guidelines and Available Operations, plus 3 more sections
Runs JavaScript scripts from its folder; calls node, npm and jq

What it does

Gmail Skill is an agent skill from benchflow-ai/skillsbench. Manage Gmail - send, read, search emails, manage labels and drafts. Use when user wants to interact with their Gmail account for email operations.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts (for example `README.md`, `docs/google-cloud-setup.md` and `package.json`).

It sits in Productivity & Automation, covering Email management. It works with Gmail. The repository describes itself as: SkillsBench evaluates how well skills work and how effective agents are at using them. The licence is Apache-2.0.

When your agent uses it

User wants to interact with their Gmail account for email operations
Tasks that involve Email management

Example prompts

“/gmail-skill”

Requirements

Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

Read Documentation On-Demand
Execute Scripts via Bash
Parse JSON Output
Chain Operations

What it can do on your machine

Read from SKILL.md and the folder at commit 9a1f4dd. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 13 files in scripts/ (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
- node
- npm
- jq
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gmail Skill loads about 1.1k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 305 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~40
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from benchflow-ai/skillsbench at commit 9a1f4dd, republished under its Apache-2.0 licence (© benchflow-ai). 305 words, ~1,081 tokens.

Download SKILL.mdSave it as .claude/skills/gmail-skill/SKILL.md (or your agent's skills folder). This skill also uses 17 other files; get the full folder from GitHub.

name: gmail-skill
description: Manage Gmail - send, read, search emails, manage labels and drafts. Use when user wants to interact with their Gmail account for email operations.

Gmail Manager Skill

This skill provides comprehensive Gmail integration through lightweight CLI scripts. All operations are token-efficient and composable.

First-Time Setup

Before using this skill, you must set up OAuth authentication:

Install dependencies:

bash

cd ~/.claude/skills/gmail-skill && npm install

Set up Google Cloud credentials:
- Follow the guide in docs/google-cloud-setup.md
- Download credentials.json and save to scripts/auth/credentials.json

Authenticate:

bash

cd ~/.claude/skills/gmail-skill && npm run setup

This will open a browser for Google OAuth and save your token locally.

Multi-Account Support

The Gmail skill supports multiple accounts (e.g., personal and work email):

Add Additional Accounts

bash

# Add a second account (from skill directory)
npm run setup -- --account work

# Add a third account
npm run setup -- --account personal

Each account needs separate OAuth authentication.

Manage Accounts

bash

# List all configured accounts
node scripts/manage-accounts.js --list

# Set default account (used when --account is not specified)
node scripts/manage-accounts.js --set-default work

# Remove an account
node scripts/manage-accounts.js --remove old-account

Using Specific Accounts

All Gmail operations support the --account parameter:

bash

# Send email from work account
node gmail-send.js --account work --to "user@example.com" --subject "..." --body "..."

# Send from personal (or omit --account to use default)
node gmail-send.js --account personal --to "friend@example.com" --subject "..." --body "..."

# Search work emails
node gmail-search.js --account work --query "is:unread"

If --account is not specified, the default account is used.

Usage Guidelines

1. Read Documentation On-Demand

When first using Gmail operations, read the comprehensive README:

bash

cat ~/.claude/skills/gmail-skill/README.md

This provides detailed usage examples for all operations.

2. Execute Scripts via Bash

All scripts are in the scripts/ directory and output JSON for easy parsing:

bash

cd ~/.claude/skills/gmail-skill/scripts

3. Parse JSON Output

All scripts return JSON. Parse the output and present relevant information to the user in a friendly format.

4. Chain Operations

Save intermediate results to files when chaining operations:

bash

# Search for emails
node gmail-search.js --query "from:user@example.com" > /tmp/search-results.json

# Read first message from results
MESSAGE_ID=$(cat /tmp/search-results.json | jq -r '.messages[0].id')
node gmail-read.js --id "$MESSAGE_ID"

Available Operations

Send Email

bash

node gmail-send.js --to "user@example.com" --subject "Subject" --body "Body text"

Search Emails

bash

node gmail-search.js --query "is:unread" --limit 10

Read Message

bash

node gmail-read.js --id "MESSAGE_ID"

Manage Labels

bash

# List all labels
node gmail-labels.js --action list

# Add label to message
node gmail-labels.js --action add --id "MESSAGE_ID" --label "Important"

Manage Drafts

bash

# Create draft
node gmail-drafts.js --action create --to "user@example.com" --subject "Subject" --body "Draft body"

# Send draft
node gmail-drafts.js --action send --id "DRAFT_ID"

Error Handling

If scripts fail:

Check that token.json exists in scripts/auth/
If token is expired, run npm run setup again
Verify the user granted all required Gmail API permissions

Best Practices

Always change to the scripts directory first to ensure relative paths work
Parse JSON output and present user-friendly summaries
Validate user input before passing to scripts
Handle errors gracefully and provide helpful error messages
Use search operators for precise email filtering (see README.md)

Token Efficiency

This skill is designed for minimal token usage:

Documentation loaded only when needed
Scripts are small and focused
JSON output is compact and parseable
No persistent server overhead

Files

SKILL.md and 17 other files (scripts) in tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill of benchflow-ai/skillsbench.

SKILL.md
.gitignore
README.md
docs/google-cloud-setup.md
package.json
scripts/action-logger.js
scripts/auth/auth-utils.js
scripts/auth/setup-oauth.js
scripts/gmail-drafts.js
scripts/gmail-every-paywall-cleanup.js
scripts/gmail-filters.js
scripts/gmail-forward.js
scripts/gmail-labels.js
scripts/gmail-read.js
scripts/gmail-search.js
scripts/gmail-send.js
scripts/manage-accounts.js
scripts/migrate-tokens.js

Open the folder on GitHubat commit 9a1f4dd

Compare with similar skills

Gmail Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gmail Skill compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Gmail Skill this skillbenchflow-ai/skillsbench	1.8k	—	~1.1k	Automated safety check: Pass	Apache-2.0	2 mo ago
Career-Ops Gmail Lead Plugincareer-ops-hq/career-ops	74k	—	~233	Automated safety check: Notes	MIT	yesterday
Gmailteam-attention/plugins-for-claude-natives	825	—	~967	Automated safety check: Pass	MIT	5 mo ago
Connect Apps with ComposioComposioHQ/awesome-claude-skills	77k	3 repos	~557	Automated safety check: Pass	None	19 days ago
Gmail Emailopen-gitagent/gitagent	710	—	~235	Automated safety check: Notes	MIT	1 mo ago
Zeleremorses/zele	299	—	~1.3k	Automated safety check: Pass	None	6 days ago

Similar skills

Career-Ops Gmail Lead Plugin
career-ops-hq/career-ops
Pulls job leads from a Gmail label into the career-ops pipeline, extracting job URLs from DMARC-passing emails and de-duplicating against existing leads.
74k GitHub stars~233 tokensUpdated yesterday
Productivity & AutomationAuto-check: notes
Gmail
team-attention/plugins-for-claude-natives
This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail.
825 GitHub stars~967 tokensUpdated 5 mo ago
Productivity & AutomationAuto-check passed
Connect Apps with Composio
ComposioHQ/awesome-claude-skills
Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.
77k GitHub starsUsed in 3 repos~557 tokens
Productivity & AutomationAuto-check passed
Gmail Email
open-gitagent/gitagent
Send emails via Gmail SMTP using App Password authentication.
710 GitHub stars~235 tokensUpdated 1 mo ago
Productivity & AutomationAuto-check: notes
Zele
remorses/zele
zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.
299 GitHub stars~1.3k tokensUpdated 6 days ago
Productivity & AutomationAuto-check passed
Google Workspace
yc-software/qm
Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.
15k GitHub stars~1.8k tokensUpdated yesterday
Productivity & AutomationAuto-check passed

Questions about Gmail Skill

What does Gmail Skill do?

Manage Gmail - send, read, search emails, manage labels and drafts. Gmail Skill is an agent skill from benchflow-ai/skillsbench. Manage Gmail - send, read, search emails, manage labels and drafts.

When should I use Gmail Skill?

Gmail Skill fits situations like: user wants to interact with their Gmail account for email operations; tasks that involve Email management.

How do I install Gmail Skill in Claude Code?

Run `npx skills add benchflow-ai/skillsbench --skill gmail-skill -a claude-code`. Or copy the skill folder (tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill in benchflow-ai/skillsbench) into .claude/skills/gmail-skill in your project. Claude Code loads it when a task matches its description.

How do I install Gmail Skill in Codex?

Run `npx skills add benchflow-ai/skillsbench --skill gmail-skill -a codex`. Or copy the skill folder (tasks-extra/scheduling-email-assistant/environment/skills/gmail-skill in benchflow-ai/skillsbench) into .agents/skills/gmail-skill in your project. Codex loads it when a task matches its description.

Can I use Gmail Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add benchflow-ai/skillsbench --skill gmail-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gmail-skill, .gemini/skills/gmail-skill, .github/skills/gmail-skill and .opencode/skills/gmail-skill in your project.

What does Gmail Skill need to run?

Going by SKILL.md and its folder, Gmail Skill needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node, npm and jq). Our summary lists: Node.js.

Does Gmail Skill access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Gmail Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Gmail Skill use?

Gmail Skill is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gmail Skill use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gmail Skill?

Skills that share tags, products or a category with Gmail Skill: Career-Ops Gmail Lead Plugin (career-ops-hq/career-ops, 74k stars), Gmail (team-attention/plugins-for-claude-natives, 825 stars), Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars) and Gmail Email (open-gitagent/gitagent, 710 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gmail Skill?

benchflow-ai (a GitHub organization) maintains it in benchflow-ai/skillsbench, which has 1,832 GitHub stars. The repository holds 180 skills in this directory. The repository was last updated on July 23, 2026.

Source: benchflow-ai/skillsbench on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Gmail Skill

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Gmail Manager Skill

First-Time Setup

Multi-Account Support

Add Additional Accounts

Manage Accounts

Using Specific Accounts

Usage Guidelines

1. Read Documentation On-Demand

2. Execute Scripts via Bash

3. Parse JSON Output

4. Chain Operations

Available Operations

Send Email

Search Emails

Read Message

Manage Labels

Manage Drafts

Error Handling

Best Practices

Token Efficiency

Files

Compare with similar skills

Similar skills

More from benchflow-ai/skillsbench

Related

Questions about Gmail Skill