Agent skill

Gmail

by win4r in win4r/MuseAI-Skills

Work with the user's Gmail: search, read threads, draft, send, reply, forward, unsubscribe from mailing lists, manage labels, and open attachments.

No licenceAuto-check: warningsProductivity & Automation

Install Gmail

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add win4r/MuseAI-Skills --skill gmail -a claude-code

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

GitHub CLI
$ gh skill install win4r/MuseAI-Skills gmail --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/win4r/MuseAI-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/opt/hatch/skills/gmail .claude/skills/gmail && 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/

Facts

Skill name
gmail
GitHub stars
326
Used in
1 other repo
Token cost
~3.7k tokens
SKILL.md length
2,156 words
Files
3
Skills in repo
25
Repo updated
First seen
Licence
None found

At a glance

Work with the user's Gmail: search, read threads, draft, send, reply, forward, unsubscribe from mailing lists, manage labels, and open attachments.

  • Tasks that involve Email management
  • SKILL.md covers Connecting, Rate limits, Common flows and Rules
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gmail is an agent skill from win4r/MuseAI-Skills. Work with the user's Gmail: search, read threads, draft, send, reply, forward, unsubscribe from mailing lists, manage labels, and open attachments.

Its SKILL.md is about 3.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `eval/scenarios.yaml` and `manifest.yaml`).

It sits in Productivity & Automation, covering Email management. It works with Gmail and Google Workspace. The repository describes itself as: muse.ai (Muse AI) skills and runtime snapshot: 68 skills, workflow guides, connector manifests. muse.ai 技能与运行环境文件;非官方存档 / Unofficial archive.

When your agent uses it

  • Tasks that involve Email management

Example prompts

  • “/gmail”

What it can do on your machine

Read from SKILL.md and the folder at commit 38bbb45. 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

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 loads about 3.7k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 2,156 words of instructions outside code blocks.

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

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: warnings

The automated check found patterns that need a careful read before installing.

  • WarningContains instruction-override wording (e.g. “without asking the user”)SKILL.md:85
    the search in each linked account, and don't tell the user an email doesn't exist until every account came up empty.

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); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 2,156 words (~3,744 tokens).

“Everything runs as hatch_gws_cli gmail . The flows below give the exact command for each task, so start there. Commands come in two kinds:”

— opening of SKILL.md by win4r
name
gmail
icon
gmail
metadata.includeInPrompt
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in opt/hatch/skills/gmail of win4r/MuseAI-Skills.

  • SKILL.md
  • eval/scenarios.yaml
  • manifest.yaml

Open the folder on GitHubat commit 38bbb45

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in win4r/MuseAI-Skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Gmail 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gmail this skillwin4r/MuseAI-Skills3261 repos~3.7kAutomated safety check: WarnNone
Google Workspaceyc-software/qm15k—~1.8kAutomated safety check: PassMIT
Gws Gmail Readgoogleworkspace/cli31k1 repos~345Automated safety check: PassApache-2.0
Gws Gmail Triagegoogleworkspace/cli31k1 repos~301Automated safety check: PassApache-2.0
Gmail Query Syntaxprovos/ironcurtain613—~971Automated safety check: PassApache-2.0
Gogtrpc-group/trpc-agent-go1.8k14 repos~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • 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 today
    Productivity & AutomationAuto-check passed
  • Gws Gmail Read

    googleworkspace/cli

    Gmail: Read a message and extract its body or headers. An agent skill from googleworkspace/cli.

    31k GitHub starsUsed in 1 repo~345 tokens
    Productivity & AutomationAuto-check passed
  • Gws Gmail Triage

    googleworkspace/cli

    Gmail: Show unread inbox summary (sender, subject, date). An agent skill from googleworkspace/cli.

    31k GitHub starsUsed in 1 repo~301 tokens
    Productivity & AutomationAuto-check passed
  • Gmail Query Syntax

    provos/ironcurtain

    Reference for Gmail's search query syntax — operators like is:sent, newerthan:, from:, has:attachment, label:, and how they compose.

    613 GitHub stars~971 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Gog

    trpc-group/trpc-agent-go

    Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

    1.8k GitHub starsUsed in 14 repos~1.1k tokens
    Productivity & AutomationAuto-check passed
  • Email Assistant

    appleweiping/WEIPING_WIKI

    Personal Gmail and Google Workspace email assistant for Vipin.

    119 GitHub stars~1.3k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from win4r/MuseAI-Skills

All 25 skills in this repo
  • Withings Health Data Reader

    win4r/MuseAI-Skills

    Reads Withings body measurements, daily activity, sleep sessions and workouts through a bundled withings command line tool and returns typed JSON records.

    326 GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Travel and Event Booking

    win4r/MuseAI-Skills

    Handles direct flight, hotel, restaurant and event-ticket bookings and live availability checks, loading the right category reference before searching or booking.

    326 GitHub starsUsed in 1 repo~4k tokens
    Auto-check passed
  • HealthEx Health Records

    win4r/MuseAI-Skills

    Connects to HealthEx through OAuth and its MCP server so you can ask about medications, lab results, conditions and other health records.

    326 GitHub starsUsed in 1 repo~3.7k tokens
    Auto-check passed
  • Product Shopping Search

    win4r/MuseAI-Skills

    Guides an agent through product searches across a catalog, a browser agent and Facebook Marketplace, favoring low prices and citing each product it names.

    326 GitHub starsUsed in 1 repo~9.1k tokens
    Auto-check passed
  • Muse Feedback Filer

    win4r/MuseAI-Skills

    Tells the agent when to offer, and how to file, a feature request or bug report with the Muse team through a feature-request command line tool, only with your approval.

    326 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: warnings
  • Duffel Flight Booking

    win4r/MuseAI-Skills

    Defines how an agent searches, books and manages flights through the Duffel CLI, and watches a booked fare when you ask for ongoing price monitoring.

    326 GitHub starsUsed in 1 repo~7k tokens
    Auto-check passed

Questions about Gmail

What does Gmail do?

Work with the user's Gmail: search, read threads, draft, send, reply, forward, unsubscribe from mailing lists, manage labels, and open attachments. Gmail is an agent skill from win4r/MuseAI-Skills. Work with the user's Gmail: search, read threads, draft, send, reply, forward, unsubscribe from mailing lists, manage labels, and open attachments.

When should I use Gmail?

Gmail fits situations like: tasks that involve Email management.

How do I install Gmail in Claude Code?

Run `npx skills add win4r/MuseAI-Skills --skill gmail -a claude-code`. Or copy the skill folder (opt/hatch/skills/gmail in win4r/MuseAI-Skills) into .claude/skills/gmail in your project. Claude Code loads it when a task matches its description.

How do I install Gmail in Codex?

Run `npx skills add win4r/MuseAI-Skills --skill gmail -a codex`. Or copy the skill folder (opt/hatch/skills/gmail in win4r/MuseAI-Skills) into .agents/skills/gmail in your project. Codex loads it when a task matches its description.

Can I use Gmail 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 win4r/MuseAI-Skills --skill gmail -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, .gemini/skills/gmail, .github/skills/gmail and .opencode/skills/gmail in your project.

What does Gmail need to run?

SKILL.md names no scripts, command-line tools or credentials: Gmail is instructions for the agent only.

Does Gmail access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Gmail safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): contains instruction-override wording (e.g. “without asking the user”). Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Gmail use?

No licence was found for Gmail or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Gmail use?

About 3.7k tokens (SKILL.md is roughly 15k 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?

Skills that share tags, products or a category with Gmail: Google Workspace (yc-software/qm, 15k stars), Gws Gmail Read (googleworkspace/cli, 31k stars), Gws Gmail Triage (googleworkspace/cli, 31k stars) and Gmail Query Syntax (provos/ironcurtain, 613 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gmail?

win4r (a GitHub user) maintains it in win4r/MuseAI-Skills, which has 326 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 28, 2026.

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