gmail-draftlisted
Install: claude install-skill hec-ovi/gmail-skill
# gmail-draft
```bash
gmail draft create --to <addr> --subject <s> --body-file <file> [--cc][--bcc][--attach]
gmail draft update --draft-id <id> --to <addr> --subject <s> --body-file <file>
gmail draft list [--query "<gmail query>"] [--max 25]
gmail draft send --draft-id <id>
gmail draft delete --draft-id <id>
```
`--json` gives the Envelope on any of them.
## When to draft instead of send
Draft by default. Send directly only when the user has seen the words and said to send
them. Drafting is the whole reason this is a separate skill from `gmail-send`: it turns an
irreversible action into a reviewable one, and the user can finish it in Gmail on their
phone.
Reach for a draft when the user says "write", "draft", "prepare", "put together", "start
an email"; when the message matters and they have not read it yet; or when you are
composing on their behalf from your own understanding of a thread.
## Writing the body
Put the body in a file and pass `--body-file`. `--body` exists for one-liners, but shell
quoting mangles anything with newlines, quotes, or a dollar sign, and you will not notice
until it is sent.
```bash
cat > /tmp/reply.txt <<'EOF'
Hi Ada,
Tuesday at 10 works. I will send an agenda beforehand.
Hector
EOF
gmail draft create --to ada@example.com --subject "Re: Tuesday" --body-file /tmp/reply.txt
```
Write in the user's voice, not yours. If you have their previous mail in context, match its
register: how they open, how they sign off, how long their sentences