gws-gmail-forward
Gmail: Forward a message to new recipients.
Install / Use
npx skills add googleworkspace/cli --skill gws-gmail-forwardInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
Our assessment of gws-gmail-forward
gws-gmail-forward scores 84/100 on our quality scale, 841st of 1,111 Security skills we index.
Its SKILL.md is 3.0 KB long, split into 6 sections with 2 code examples: a solid amount of guidance for an agent.
With 31,133 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so gws-gmail-forward is actively maintained.
- Our last check on 2026-11-05 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-27. Automated pattern scan on 2026-09-26. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
gws-gmail-forward compared with similar skills
All 4 of these similar skills score higher than gws-gmail-forward; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| gws-gmail-forward (this skill)by googleworkspace | 84 | 31.1k | 53d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install gws-gmail-forward?
- Run
npx skills add googleworkspace/cli --skill gws-gmail-forward. The install tabs above show the steps for each supported agent. - Which AI agents does gws-gmail-forward work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is gws-gmail-forward safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is gws-gmail-forward still maintained?
- The repository was last updated about 2 months ago, so gws-gmail-forward is actively maintained.
Skill content
View source on GitHubname: gws-gmail-forward description: "Gmail: Forward a message to new recipients." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws gmail +forward --help"
gmail +forward
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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 dave@example.com
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body 'FYI see below'
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --cc eve@example.com
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '<p>FYI</p>' --html
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com -a notes.pdf
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --no-original-attachments
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --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
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
