gws-gmail-draft

name	gws-gmail-draft
description	Create unsent Gmail drafts through the named work, personal, or columbia gws account alias with a portable draft-only helper. Use when the user explicitly asks to save or create an email in Gmail drafts.

Gmail Draft Creation

Create Gmail drafts through gws-gmail-draft. The helper calls only Gmail users.drafts.create; it never calls a send method.

Intent Gate

• An explicit request such as “save this in Gmail drafts” or “create a Gmail draft” authorizes draft creation in the named mailbox.
• A vague request such as “draft an email” means compose text locally first. Ask before writing it into Gmail.
• Sending is a separate action. Never interpret draft approval as send approval, and always obtain explicit confirmation immediately before sending.

Accounts

• work → [e-mail]
• personal → [e-mail]
• columbia → authenticated mailbox [e-mail]; default visible From address [e-mail]

If the intended mailbox is unclear, ask which alias to use before creating the draft.

Workflow

1. Read ../gws-shared/SKILL.md and ../gws-account-switch/SKILL.md.
2. Confirm ~/.config/gws/accounts/<alias>.json exists without printing it.
3. For the columbia alias, default the visible From address to the accepted send-as identity [e-mail]. Use [e-mail] only when the user explicitly asks for it or the context specifically requires the primary mailbox identity.
4. Prefer a body file for long or sensitive content so it is not exposed in process arguments.
5. Run --dry-run first and review the safe summary, including the resolved From address.
6. If Gmail intent is explicit, run the same command without --dry-run.
7. Report the account alias, resolved From address, recipients, subject, and returned draft ID. State clearly that nothing was sent.

Examples

gws-gmail-draft work \
  --to [e-mail] \
  --subject "Follow-up" \
  --body-file ./draft.txt \
  --dry-run

gws-gmail-draft work \
  --to [e-mail] \
  --cc [e-mail] \
  --subject "Follow-up" \
  --body-file ./draft.txt

gws-gmail-draft personal \
  --to [e-mail] \
  --subject "Invoice" \
  --body-file ./body.html \
  --html \
  --attach ./invoice.pdf

--to, --cc, --bcc, and --attach are repeatable. Address flags also accept comma-separated values. A draft may omit recipients when the message is intentionally incomplete.

Permission Boundary

Google does not provide a general draft-only OAuth scope. The required gmail.compose scope also technically permits sending. The helper and this skill are workflow guardrails, not a cryptographic restriction on the credential.

Never bypass the helper with gmail +send, messages.send, or drafts.send while performing a draft-creation request.