Agent skill

Gmail Reply via gws

by googleworkspace in googleworkspace/cli

Replies to a Gmail message from the gws CLI with automatic threading, plus CC, BCC, extra recipients, attachments, HTML bodies and draft or dry-run modes.

Apache-2.0Auto-check passedProductivity & Automation

Install Gmail Reply via gws

skills CLI
$ npx skills add googleworkspace/cli --skill gws-gmail-reply -a claude-code

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

GitHub CLI
$ gh skill install googleworkspace/cli gws-gmail-reply --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/googleworkspace/cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gws-gmail-reply .claude/skills/gws-gmail-reply && 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-reply
GitHub stars
31k
Token cost
~655 tokens
SKILL.md length
220 words
Files
1
Skills in repo
77
Repo updated
First seen
Licence
Apache-2.0

At a glance

Replies to a Gmail message from the gws CLI with automatic threading, plus CC, BCC, extra recipients, attachments, HTML bodies and draft or dry-run modes.

  • Replying to a specific Gmail message while keeping the thread intact
  • SKILL.md covers Usage, Flags, Examples and Tips, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Saving a reply as a draft for review before sending

What it does

The skill wraps the gws gmail +reply command, which takes a message ID and a body. It sets the In-Reply-To, References and threadId headers by itself and quotes the original message in the reply. Optional flags change the sender alias, add To, CC and BCC recipients, attach files, which can be repeated, and treat the body as HTML, in which case the quoted block keeps Gmail's own CSS classes and inline images stay attached through cid references.

Two flags make it safer to try: --dry-run shows the request without sending it, and --draft saves the reply as a draft instead of sending, since otherwise the reply goes out immediately. Before use the agent must read the gws-shared skill for authentication, global flags and security rules, and run gws generate-skills if it is missing. Reply-all has its own +reply-all command, and the gws-gmail skill covers other mail commands.

When your agent uses it

  • Replying to a specific Gmail message while keeping the thread intact
  • Saving a reply as a draft for review before sending
  • Replying with extra recipients or file attachments
  • Previewing the request a reply would send with a dry run

Example prompts

  • “Reply to that message from Carol with a short thanks and save it as a draft.”
  • “Reply to the latest thread from the vendor and copy carol@example.com.”
  • “Do a dry run of a reply that attaches report.pdf.”

Requirements

  • The `gws` Google Workspace CLI, authenticated for Gmail

What it can do on your machine

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

Gmail Reply via gws loads about 655 tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 220 words of instructions outside code blocks.

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

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

The full file from googleworkspace/cli at commit a3768d0, republished under its Apache-2.0 licence (© googleworkspace). 220 words, ~655 tokens.

Download SKILL.mdSave it as .claude/skills/gws-gmail-reply/SKILL.md (or your agent's skills folder).
name
gws-gmail-reply
description
Gmail: Reply to a message (handles threading automatically).
metadata.version
0.22.5

gmail +reply

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Reply to a message (handles threading automatically)

Usage

bash
gws gmail +reply --message-id <ID> --body <TEXT>

Flags

FlagRequiredDefaultDescription
--message-id✓—Gmail message ID to reply to
--body✓—Reply body (plain text, or HTML with --html)
--from——Sender address (for send-as/alias; omit to use account default)
--to——Additional To email address(es), comma-separated
--attach——Attach a file (can be specified multiple times)
--cc——CC email address(es), comma-separated
--bcc——BCC email address(es), comma-separated
--html——Treat --body as HTML content (default is plain text)
--dry-run——Show the request that would be sent without executing it
--draft——Save as draft instead of sending

Examples

bash
gws gmail +reply --message-id 18f1a2b3c4d --body 'Thanks, got it!'
gws gmail +reply --message-id 18f1a2b3c4d --body 'Looping in Carol' --cc carol@example.com
gws gmail +reply --message-id 18f1a2b3c4d --body 'Adding Dave' --to dave@example.com
gws gmail +reply --message-id 18f1a2b3c4d --body '<b>Bold reply</b>' --html
gws gmail +reply --message-id 18f1a2b3c4d --body 'Updated version' -a updated.docx
gws gmail +reply --message-id 18f1a2b3c4d --body 'Draft reply' --draft

Tips

  • Automatically sets In-Reply-To, References, and threadId headers.
  • Quotes the original message in the reply body.
  • --to adds extra recipients to the To field.
  • Use -a/--attach to add file attachments. Can be specified multiple times.
  • With --html, the quoted block uses Gmail's gmail_quote CSS classes and preserves HTML formatting. Use fragment tags (<p>, <b>, <a>, etc.) — no <html>/<body> wrapper needed.
  • With --html, inline images in the quoted message are preserved via cid: references.
  • Use --draft to save the reply as a draft instead of sending it immediately.
  • For reply-all, use +reply-all instead.

See Also

© googleworkspace, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/gws-gmail-reply of googleworkspace/cli.

Open the folder on GitHubat commit a3768d0

Compare with similar skills

Gmail Reply via gws 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 Reply via gws compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gmail Reply via gws this skillgoogleworkspace/cli31k—~655Automated safety check: PassApache-2.0
Prismer Google WorkspacePrismer-AI/PrismerCloud1.6k3 repos~4.2kAutomated safety check: PassMIT
Google Workspaceyc-software/qm15k—~1.8kAutomated safety check: PassMIT
Google Workspace CLIlaude-institute/headlong1.2k—~1.2kAutomated safety check: PassApache-2.0
Email Draftingmgonto/executive-assistant-skills118—~2.8kAutomated safety check: PassNone
Gmail Query Syntaxprovos/ironcurtain613—~971Automated safety check: PassApache-2.0

Similar skills

  • Prismer Google Workspace

    Prismer-AI/PrismerCloud

    Gives an agent account-scoped access to Gmail, Calendar, Drive, Contacts, Docs and Sheets through the gws CLI or a bundled Python client.

    1.6k GitHub starsUsed in 3 repos~4.2k tokens
    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
  • Google Workspace CLI

    laude-institute/headlong

    Drives Google Drive, Gmail, Calendar, Sheets, Docs and Chat from the shell with the gws CLI, including its sign-in, flags, helper commands and safety rules.

    1.2k GitHub stars~1.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Email Drafting

    mgonto/executive-assistant-skills

    Draft email replies for Gonto's Gmail accounts (m@gon.to, gonto@hypergrowthpartners.com).

    118 GitHub stars~2.8k tokensUpdated 7 mo ago
    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

More from googleworkspace/cli

All 77 skills in this repo
  • Gmail Inbox Watcher

    googleworkspace/cli

    Streams new Gmail messages as NDJSON from the gws command line tool using Google Pub/Sub, with label filters, batch settings and optional per-message files.

    31k GitHub starsUsed in 1 repo~476 tokens
    Auto-check passed
  • Workspace Events Subscribe

    googleworkspace/cli

    Subscribes to Google Workspace events with the gws CLI and streams them as NDJSON, with flags for the target resource, event types, Pub/Sub project and output directory.

    31k GitHub stars~509 tokensUpdated yesterday
    Auto-check passed
  • Gmail Message Forwarder

    googleworkspace/cli

    Forwards an existing Gmail message to new recipients from the command line with the gws CLI, with options for notes, attachments, CC, BCC and drafts.

    31k GitHub stars~763 tokensUpdated yesterday
    Auto-check passed
  • Gws Calendar Agenda

    googleworkspace/cli

    Google Calendar: Show upcoming events across all calendars. An agent skill from googleworkspace/cli.

    31k GitHub starsUsed in 1 repo~389 tokens
    Auto-check passed
  • Gmail Reply-All Command

    googleworkspace/cli

    Replies to everyone on a Gmail message through the gws CLI, with threading handled automatically, options to add or drop recipients, and a draft mode.

    31k GitHub stars~736 tokensUpdated yesterday
    Auto-check passed
  • Gws Drive Upload

    googleworkspace/cli

    Google Drive: Upload a file with automatic metadata. An agent skill from googleworkspace/cli.

    31k GitHub starsUsed in 1 repo~322 tokens
    Auto-check passed

Questions about Gmail Reply via gws

What does Gmail Reply via gws do?

Replies to a Gmail message from the gws CLI with automatic threading, plus CC, BCC, extra recipients, attachments, HTML bodies and draft or dry-run modes. The skill wraps the gws gmail +reply command, which takes a message ID and a body. It sets the In-Reply-To, References and threadId headers by itself and quotes the original message in the reply.

When should I use Gmail Reply via gws?

Gmail Reply via gws fits situations like: replying to a specific Gmail message while keeping the thread intact; saving a reply as a draft for review before sending; replying with extra recipients or file attachments; previewing the request a reply would send with a dry run.

How do I install Gmail Reply via gws in Claude Code?

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

How do I install Gmail Reply via gws in Codex?

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

Can I use Gmail Reply via gws 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 googleworkspace/cli --skill gws-gmail-reply -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-reply, .gemini/skills/gws-gmail-reply, .github/skills/gws-gmail-reply and .opencode/skills/gws-gmail-reply in your project.

What does Gmail Reply via gws need to run?

SKILL.md names no scripts, command-line tools or credentials: Gmail Reply via gws is instructions for the agent only. Our summary lists: The `gws` Google Workspace CLI, authenticated for Gmail.

Does Gmail Reply via gws 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 Reply via gws 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 Gmail Reply via gws use?

Gmail Reply via gws 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 Reply via gws use?

About 655 tokens (SKILL.md is roughly 2.6k 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 Reply via gws?

Skills that share tags, products or a category with Gmail Reply via gws: Prismer Google Workspace (Prismer-AI/PrismerCloud, 1.6k stars), Google Workspace (yc-software/qm, 15k stars), Google Workspace CLI (laude-institute/headlong, 1.2k stars) and Email Drafting (mgonto/executive-assistant-skills, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gmail Reply via gws?

googleworkspace (a GitHub organization) maintains it in googleworkspace/cli, which has 31,265 GitHub stars. The repository holds 77 skills in this directory. The repository was last updated on October 6, 2026.

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