Official agent skill

Gws Gmail

by JetBrains in JetBrains/skills

“Gmail: Send, read, and manage email.”

— description from SKILL.md by JetBrains
OfficialNo licenceAuto-check passedProductivity & Automation

Install Gws Gmail

skills CLI
$ npx skills add JetBrains/skills --skill gws-gmail -a claude-code

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

GitHub CLI
$ gh skill install JetBrains/skills gws-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/JetBrains/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/gws-gmail .claude/skills/gws-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
gws-gmail
GitHub stars
366
Used in
2 other repos
Token cost
~537 tokens
SKILL.md length
169 words
Files
1
Skills in repo
76
Repo updated
First seen
Licence
None found

At a glance

  • SKILL.md covers Helper Commands, API Resources and Discovering Commands
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Gws Gmail is an official skill in JetBrains/skills (366 stars). Its SKILL.md is about 537 tokens, and copies of it appear in 2 other owners' repositories. No licence found.

What it can do on your machine

Read from SKILL.md and the folder at commit e0f258b. 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 (its code samples are bash).

    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

Gws Gmail loads about 537 tokens when it runs. Until then it costs about 12 tokens; SKILL.md has 169 words of instructions outside code blocks.

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

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); 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 169 words (~537 tokens).

“Before calling any API method, inspect it:”

— opening of SKILL.md by JetBrains
name
gws-gmail
version
1.0.0
metadata.short-description
Send, read, and manage Gmail
metadata.author
Google Workspace
metadata.source
https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

Read the full SKILL.md on GitHub

Files

Just SKILL.md in gws-gmail of JetBrains/skills.

Open the folder on GitHubat commit e0f258b

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in JetBrains/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Gws 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.

Gws Gmail compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gws Gmail this skillJetBrains/skills3662 repos~537Automated safety check: PassNone
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
Gogtrpc-group/trpc-agent-go1.9k15 repos~1.1kAutomated safety check: PassApache-2.0
Gmail Query Syntaxprovos/ironcurtain612—~971Automated 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
  • Gog

    trpc-group/trpc-agent-go

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

    1.9k GitHub starsUsed in 15 repos~1.1k 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.

    612 GitHub stars~971 tokensUpdated 2 days ago
    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 JetBrains/skills

All 76 skills in this repo
  • Playwright

    JetBrains/skills

    Official

    A skill your agent uses when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via playwright-cli…

    366 GitHub starsUsed in 11 repos~986 tokens
    Auto-check passed
  • Skill Creator

    JetBrains/skills

    Official

    Guide for creating effective skills. An agent skill from JetBrains/skills.

    366 GitHub starsUsed in 122 repos~4.7k tokens
    Auto-check passed
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    366 GitHub starsUsed in 4 repos~776 tokens
    Auto-check passed
  • Imagegen

    JetBrains/skills

    Official

    A skill your agent uses when the user asks to generate or edit images via the OpenAI Image API (for example: generate image, edit/inpaint/mask, background removal or replacement, transparent…

    366 GitHub starsUsed in 3 repos~2.5k tokens
    Auto-check passed
  • Speech

    JetBrains/skills

    Official

    A skill your agent uses when the user asks for text-to-speech narration or voiceover, accessibility reads, audio prompts, or batch speech generation via the OpenAI Audio API; run the bundled CLI…

    366 GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • Screenshot

    JetBrains/skills

    Official

    A skill your agent uses when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are…

    366 GitHub starsUsed in 6 repos~2k tokens
    Auto-check passed

Questions about Gws Gmail

How do I install Gws Gmail in Claude Code?

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

How do I install Gws Gmail in Codex?

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

Can I use Gws 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 JetBrains/skills --skill gws-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/gws-gmail, .gemini/skills/gws-gmail, .github/skills/gws-gmail and .opencode/skills/gws-gmail in your project.

What does Gws Gmail need to run?

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

Does Gws 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 Gws Gmail 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. Review the folder before installing.

What licence does Gws Gmail use?

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

How many tokens does Gws Gmail use?

About 537 tokens (SKILL.md is roughly 2.1k 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 Gws Gmail?

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

Who maintains Gws Gmail?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/skills, which has 366 GitHub stars. The repository holds 76 skills in this directory. The repository was last updated on June 29, 2026.

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