Gws Gmail Forward Agent Skill
Gmail: Forward a message to new recipients.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/googleworkspace/cli --skill gws-gmail-forwardThe instruction itself
6 sections, as written by the authorgmail +forward
> PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.
Forward a message to new recipients
Usage
gws gmail +forward --message-id <ID> --to <EMAILS>
Flags
| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| --message-id | ✓ | — | Gmail message ID to forward |
| --to | ✓ | — | Recipient email address(es), comma-separated |
| --from | — | — | Sender address (for send-as/alias; omit to use account default) |
| --body | — | — | Optional note to include above the forwarded message (plain text, or HTML with --html) |
| --no-original-attachments | — | — | Do not include file attachments from the original message (inline images in --html mode are preserved) |
| --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 +forward --message-id 18f1a2b3c4d --to [email protected]
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --body 'FYI see below'
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --cc [email protected]
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --body '<p>FYI</p>' --html
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] -a notes.pdf
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --no-original-attachments
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --draft
Tips
- Includes the original message with sender, date, subject, and recipients.
- Original attachments are included by default (matching Gmail web behavior).
- With --html, inline images are also preserved via cid: references.
- In plain-text mode, inline images are not included (matching Gmail web).
- Use --no-original-attachments to forward without the original message's files.
- Use -a/--attach to add extra file attachments. Can be specified multiple times.
- Combined size of original and user attachments is limited to 25MB.
- With --html, the forwarded block uses Gmail's gmail_quote CSS classes and preserves HTML formatting. Use fragment tags (<p>, <b>, <a>, etc.) — no <html>/<body> wrapper needed.
- Use --draft to save the forward as a draft instead of sending it immediately.
See Also
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Other skills for the same job
different authors, same section of the catalogue
Analyzes meeting transcripts and recordings to uncover behavioral patterns, communication insights, and actionable feedback. Identifies when you avoid conflict, use filler words, dominate conversations, or miss opportunities to listen. Perfect for professionals seeking to improve their communication and leadership skills.
Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like "make me a GIF for Slack of X doing Y".
Analyzes your recent Claude Code chat history to identify coding patterns, development gaps, and areas for improvement, curates relevant learning resources from HackerNews, and automatically sends a personalized growth report to your Slack DMs.
Knowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack.
A skill that creates new Claude skills and automatically shares them on Slack using Rube for seamless team collaboration and skill discovery.
Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.
Prepare meeting materials with Notion context and Codex research; use when gathering context, drafting agendas/pre-reads, and tailoring materials to attendees.
Interactive daily standup/meeting update generator. Use when user says 'daily', 'standup', 'scrum update', 'status update', 'what did I do yesterday', 'prepare for meeting', 'morning update', or 'team sync'. Pulls activity from GitHub, Jira, and Claude Code session history. Conducts 4-question interview (yesterday, today, blockers, discussion topics) and generates formatted Markdown update.
How to use it
Take googleworkspace/gws-gmail-forward from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.