Gws Gmail Forward

Gmail: Forward a message to new recipients.

Security Scan

The skill is internally consistent: it just wraps a gws CLI command to forward Gmail messages and does not request unrelated credentials or install code, but it depends on an external gws binary and a shared auth doc you should inspect first.

Purpose & Capability

The name/description (Gmail forward) match the runtime instructions which call the gws CLI. Requiring the gws binary is expected for a CLI-wrapper skill and there are no unrelated binaries or environment variables requested.

Instruction Scope

SKILL.md only documents using gws gmail +forward with well-scoped flags. The file points the operator to ../gws-shared/SKILL.md for auth/global flags, which is relevant to executing Gmail actions; the skill does not itself instruct reading arbitrary unrelated system files or exfiltrating data.

Install Mechanism

No install spec or archive downloads are present (instruction-only skill). Nothing is written to disk by the skill itself during install.

Credentials

The skill declares no env vars or credentials itself, but it delegates auth and global flags to gws/gws-shared. That means actual credential access and storage are handled outside this SKILL.md (in the gws binary or gws-shared configuration). You should review those artifacts to confirm what credentials/config they require and how they are stored.

Persistence & Privilege

always is false and the skill is user-invocable only. It does not request persistent platform privileges or modify other skills' configs.

Assessment

This skill appears to be a thin wrapper around the gws CLI and is coherent with its purpose, but before installing: (1) verify the provenance and integrity of the gws binary you will run (trusted source, expected version); (2) open and review ../gws-shared/SKILL.md (or the gws auth docs) to see what credentials or tokens it requires and how they are stored; (3) test with --dry-run and --draft to confirm behavior; and (4) be aware that forwarding will send full message content and attachments to whatever recipients you specify, so confirm recipient addresses and organizational policy before use.

gmail +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 [e-mail]
gws gmail +forward --message-id 18f1a2b3c4d --to [e-mail] --body 'FYI see below'
gws gmail +forward --message-id 18f1a2b3c4d --to [e-mail] --cc [e-mail]
gws gmail +forward --message-id 18f1a2b3c4d --to [e-mail] --body '<p>FYI</p>' --html
gws gmail +forward --message-id 18f1a2b3c4d --to [e-mail] -a notes.pdf
gws gmail +forward --message-id 18f1a2b3c4d --to [e-mail] --no-original-attachments
gws gmail +forward --message-id 18f1a2b3c4d --to [e-mail] --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