Index of every page on this site: llms.txt
All skills
googleworkspace avatar

/gws-gmail-reply

@cd3697e
by Google Workspacegoogleworkspace/cli32k stars
1,997
Run it yourself

Gmail: Reply to a message (handles threading automatically).

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-gmail-reply

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈19 tokens for metadata: the name and description. ≈603 when used: this file.

How this Skill uses context

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈78 characters, or 1.0%.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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

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

Flags

Flag Required Default Description
--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

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

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is generally safe but introduces an indirect prompt injection surface due to parsing and incorporating untrusted external data (email bodies) into processing tasks.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    1/1 file flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at cd3697e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 8 months ago
Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws gmail +reply --help"
  }
}
  • CLI
  • gmail
  • google-workspace
  • email
  • threading
  • gws

README badge

README badge for googleworkspace/cli/gws-gmail-reply

Sends a reply to a Gmail message via the gws CLI, automatically handling message threading, quoting, and optional attachments or CC/BCC recipients. Use this when an AI agent needs to respond to a specific email within a conversation thread.

Generated from the current SKILL.md.

Does this automatically handle reply threading?
Yes. The skill automatically sets In-Reply-To, References, and threadId headers, and quotes the original message in the reply body.
Can I send a reply-all instead?
No. Use the +reply-all skill instead for reply-all functionality.
Does this support HTML email bodies?
Yes. Use the --html flag to treat --body as HTML content. Inline images in the quoted message are preserved via cid: references.
Can I attach files to the reply?
Yes. Use the --attach or -a flag, which can be specified multiple times to add multiple file attachments.
What authentication does this require?
You must read gws-shared/SKILL.md for auth setup and global flags. The gws binary must be installed and configured.

Generated from the current SKILL.md. These answers refresh after source changes.