{"id":"fc933fe4-a093-41b3-a40e-72822b4157a4","shortId":"N7tuWP","kind":"skill","title":"gws-gmail-forward","tagline":"Gmail: Forward a message to new recipients.","description":"# gmail +forward\n\n> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.\n\nForward a message to new recipients\n\n## Usage\n\n```bash\ngws gmail +forward --message-id --to \n```\n\n## Flags\n\n| Flag | Required | Default | Description |\n|------|----------|---------|-------------|\n| `--message-id` | ✓ | — | Gmail message ID to forward |\n| `--to` | ✓ | — | Recipient email address(es), comma-separated |\n| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |\n| `--body` | — | — | Optional note to include above the forwarded message (plain text, or HTML with --html) |\n| `--no-original-attachments` | — | — | Do not include file attachments from the original message (inline images in --html mode are preserved) |\n| `--attach` | — | — | Attach a file (can be specified multiple times) |\n| `--cc` | — | — | CC email address(es), comma-separated |\n| `--bcc` | — | — | BCC email address(es), comma-separated |\n| `--html` | — | — | Treat --body as HTML content (default is plain text) |\n| `--dry-run` | — | — | Show the request that would be sent without executing it |\n| `--draft` | — | — | Save as draft instead of sending |\n\n## Examples\n\n```bash\ngws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com\ngws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body 'FYI see below'\ngws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --cc eve@example.com\ngws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '

FYI

' --html\ngws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com -a notes.pdf\ngws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --no-original-attachments\ngws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --draft\n```\n\n## Tips\n\n- Includes the original message with sender, date, subject, and recipients.\n- Original attachments are included by default (matching Gmail web behavior).\n- With --html, inline images are also preserved via cid: references.\n- In plain-text mode, inline images are not included (matching Gmail web).\n- Use --no-original-attachments to forward without the original message's files.\n- Use -a/--attach to add extra file attachments. Can be specified multiple times.\n- Combined size of original and user attachments is limited to 25MB.\n- With --html, the forwarded block uses Gmail's gmail_quote CSS classes and preserves HTML formatting. Use fragment tags (

, , , etc.) — no / wrapper needed.\n- Use --draft to save the forward as a draft instead of sending it immediately.\n\n## See Also\n\n- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth\n- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands","tags":["gws","gmail","forward","cli","googleworkspace","agent-skills","ai-agent","automation","discovery-api","gemini-cli-extension","google-admin","google-api"],"capabilities":["skill","source-googleworkspace","skill-gws-gmail-forward","topic-agent-skills","topic-ai-agent","topic-automation","topic-cli","topic-discovery-api","topic-gemini-cli-extension","topic-google-admin","topic-google-api","topic-google-calendar","topic-google-chat","topic-google-docs","topic-google-drive"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/googleworkspace/cli/gws-gmail-forward","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add googleworkspace/cli","source_repo":"https://github.com/googleworkspace/cli","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 25185 github stars · SKILL.md body (2,809 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T06:52:35.883Z","embedding":null,"createdAt":"2026-04-18T20:25:02.128Z","updatedAt":"2026-04-22T06:52:35.883Z","lastSeenAt":"2026-04-22T06:52:35.883Z","tsv":"'/alias':77 '/gws-gmail/skill.md':385 '/gws-shared/skill.md':16,377 '18f1a2b3c4d':181,190,203,214,226,237,250 '25mb':334 'account':81 'add':315 'address':65,72,130,138 'also':280,373 'attach':101,106,118,119,243,266,302,313,318,330 'auth':18,381 'bash':41,174 'bcc':135,136 'behavior':274 'block':339 'bodi':83,145,193,217 'cc':127,128,206 'cid':283 'class':346 'combin':324 'comma':68,133,141 'comma-separ':67,132,140 'command':392 'content':148 'creat':32 'css':345 'date':261 'dave@example.com':183,192,205,216,228,239,252 'default':52,82,149,270 'descript':53 'draft':166,169,253,359,366 'dri':154 'dry-run':153 'email':64,129,137,391 'es':66,131,139 'etc':354 'eve@example.com':207 'exampl':173 'execut':164 'extra':316 'file':105,121,310,317 'flag':20,49,50,379 'format':350 'forward':4,6,13,34,44,61,90,177,186,199,210,222,233,246,304,338,363 'fragment':352 'fyi':194,218 'generat':29 'generate-skil':28 'global':19,378 'gmail':3,5,12,43,57,176,185,198,209,221,232,245,272,296,341,343,384 'gws':2,27,42,175,184,197,208,220,231,244,375,383 'gws-gmail':382 'gws-gmail-forward':1 'gws-share':374 'html':95,97,114,143,147,219,276,336,349 'id':47,56,59,180,189,202,213,225,236,249 'imag':112,278,291 'immedi':371 'includ':87,104,255,268,294 'inlin':111,277,290 'instead':170,367 'limit':332 'manag':390 'match':271,295 'messag':8,36,46,55,58,91,110,179,188,201,212,224,235,248,258,308 'message-id':45,54,178,187,200,211,223,234,247 'miss':25 'mode':115,289 'multipl':125,322 'need':357 'new':10,38 'no-original-attach':98,240,299 'note':85 'notes.pdf':230 'omit':78 'option':84 'origin':100,109,242,257,265,301,307,327 'plain':92,151,287 'plain-text':286 'prerequisit':14 'preserv':117,281,348 'quot':344 'read':15,388 'recipi':11,39,63,264 'refer':284 'request':158 'requir':51 'rule':23 'run':26,155 'save':167,361 'secur':22 'see':195,372 'send':75,172,369,387 'send-a':74 'sender':71,260 'sent':162 'separ':69,134,142 'share':376 'show':156 'size':325 'skill':30 'skill-gws-gmail-forward' 'source-googleworkspace' 'specifi':124,321 'subject':262 'tag':353 'text':93,152,288 'time':126,323 'tip':254 'topic-agent-skills' 'topic-ai-agent' 'topic-automation' 'topic-cli' 'topic-discovery-api' 'topic-gemini-cli-extension' 'topic-google-admin' 'topic-google-api' 'topic-google-calendar' 'topic-google-chat' 'topic-google-docs' 'topic-google-drive' 'treat':144 'usag':40 'use':80,298,311,340,351,358 'user':329 'via':282 'web':273,297 'without':163,305 'would':160 'wrapper':356","prices":[{"id":"006bd70b-6dca-4574-a05f-38811c82721e","listingId":"fc933fe4-a093-41b3-a40e-72822b4157a4","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"googleworkspace","category":"cli","install_from":"skills.sh"},"createdAt":"2026-04-18T20:25:02.128Z"}],"sources":[{"listingId":"fc933fe4-a093-41b3-a40e-72822b4157a4","source":"github","sourceId":"googleworkspace/cli/gws-gmail-forward","sourceUrl":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-forward","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:54.121Z","lastSeenAt":"2026-04-22T06:52:35.883Z"},{"listingId":"fc933fe4-a093-41b3-a40e-72822b4157a4","source":"skills_sh","sourceId":"googleworkspace/cli/gws-gmail-forward","sourceUrl":"https://skills.sh/googleworkspace/cli/gws-gmail-forward","isPrimary":true,"firstSeenAt":"2026-04-18T20:25:02.128Z","lastSeenAt":"2026-04-22T06:40:12.887Z"}],"details":{"listingId":"fc933fe4-a093-41b3-a40e-72822b4157a4","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"googleworkspace","slug":"gws-gmail-forward","github":{"repo":"googleworkspace/cli","stars":25185,"topics":["agent-skills","ai-agent","automation","cli","discovery-api","gemini-cli-extension","google-admin","google-api","google-calendar","google-chat","google-docs","google-drive","google-sheets","google-workspace","oauth2","rust"],"license":"apache-2.0","html_url":"https://github.com/googleworkspace/cli","pushed_at":"2026-04-22T06:40:36Z","description":"Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.","skill_md_sha":"d433cef541855ab42946da2bc65f3f5fd1a7023c","skill_md_path":"skills/gws-gmail-forward/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-forward"},"layout":"multi","source":"github","category":"cli","frontmatter":{"name":"gws-gmail-forward","description":"Gmail: Forward a message to new recipients."},"skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-gmail-forward"},"updatedAt":"2026-04-22T06:52:35.883Z"}}