gmail-draft
/gmail-draft
Use this skill to compose a Gmail draft from text content in the conversation. Accepts a body, recipient list, and subject — either from the user or from context — and creates a draft in the user's Gmail Drafts folder via gws.
- Author
- opendatahub-io ↗
- Repository
- ai-helpers ↗
- Licence
- Apache-2.0
- Last repository change
- 22.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/create_draft.py
What it does and when to use it
Use this skill to compose a Gmail draft from text content in the conversation. Accepts a body, recipient list, and subject — either from the user or from context — and creates a draft in the user's Gmail Drafts folder via gws.
Arguments
/gmail-draft [subject]
Original author description
Use this skill to compose a Gmail draft from text content in the conversation. Accepts a body, recipient list, and subject — either from the user or from context — and creates a draft in the user's Gmail Drafts folder via gws.
How it works
- Prerequisites
- Step 1: Gather Recipients, Subject, and Body
- Step 2: Present for Review
- Step 3: Create the Draft
- Step 4: Confirm
- Error Reference
SKILL.md preview
---
name: gmail-draft
description: >-
Use this skill to compose a Gmail draft from text content in the conversation.
Accepts a body, recipient list, and subject — either from the user or from
context — and creates a draft in the user's Gmail Drafts folder via gws.
argument-hint: "[subject]"
allowed-tools: Bash, AskUserQuestion
user-invocable: true
metadata:
author: dhellman
version: "1.0"
tags: gmail, email, draft, google-workspace
---
# Gmail Draft
Compose a Gmail draft from text content provided in the conversation.
## Prerequisites
- `gws` binary must be on `$PATH`
- Authenticated with Gmail compose scope: run `gws auth login` (not `--readonly`)
If `gws` is not installed or authentication fails, tell the user to follow the
setup instructions in the `google-workspace` skill.
Helper scripts are located in `${CLAUDE_SKILL_DIR}` and require Python 3.10+.
---
## Step 1: Gather Recipients, Subject, and Body
Collect the three required inputs. Sources depend on how the skill was invoked:
- **From another skill** (e.g. `email-meeting-summary`): recipients, subject,
and body are passed in context — use them directly.
- **Standalone invocation**: use `AskUserQuestion` to collect any that are
missing:
- Recipients: "Who should receive this email? (comma-separated addresses)"
- Subject: "What should the subject line be?"
- Body: "Paste or describe the content you want in the email body."
---
## Step 2: Present for Review
Show the user the draft details before creating:
```text
To: <recipients>
Subject: <subject>
<body>
```
Ask:
> "Does this look right? Reply with any edits, or say 'send' to create the
> draft."
Incorporate edits and re-present until the user approves.
---
## Step 3: Create the Draft
Write the body to a temp file, then call `create_draft.py`:
```bash
BODY_FILE=$(mktemp /tmp/gmail_draft_body.XXXXXX)
cat > "$BODY_FILE" << 'BODY_EOF'
<approved body text>
BODY_EOF
python3 "${CLAUDE_SKILL_DIR}/scripts/create_draft.py" \
--to "<recipients>" \
--subject "<subject>" \
--body-file "$BODY_FILE"
```
---
## Step 4: Confirm
On success, tell the user:
> "Draft created. You can find it in the Drafts folder in Gmail at
> https://mail.google.com/mail/#drafts. Review it before sending."
If the script exits with an error, show the error message and suggest the user
check `gws auth login` permissions (the Gmail scope must include draft
creation).
---
## Error Reference
| Situation | Action |
|---|---|
| `gws` not found | Tell user to install `gws` and add it to PATH |
| Auth error (401/403) | Tell user to run `gws auth login` (without `--readonly`) |
| `create_draft.py` fails | Show error; check Gmail scope in `gws auth login` |
Files in this package (2)
- SKILL.md 3 KB
- scripts/create_draft.py 2 KB
Versions
The database has no other skills named gmail-draft.
Database snapshot: 13.11.2026 · package version 4193606b9ec0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100gws-gmail
Gmail (Google Workspace):通过 gws CLI 发送、阅读、回复、转发、整理 Gmail 邮件,以及监听新邮件推送。Use when user wants to send/read/reply/forward/triage/watch Gmail messages, manage labels/drafts/threads, or operate on Google Workspace Gmail. Do not use for Feishu/Lark mail (use lark-mail instead). - 90gws-gmail
Google Gmail CLI operations via gws. Use when users need to list emails, read messages, send email, manage labels, drafts, attachments, batch operations, or trash messages. Triggers: gmail, email, inbox, send email, mail, labels, archive, trash, drafts, attachments. - 100opencode-gws
Use for any request about the user's Gmail, Google Calendar, Drive, Docs, Sheets, Tasks or other Google Workspace data, such as "check my inbox", "what's on my calendar", "find that doc", "send this email" or "share the file": how the gws_* tools find, read and change it… - 100gws
Google Workspace CLI (gws) — unified command-line tool for Gmail, Drive, Sheets, Docs, Calendar, Chat, Admin, and 40+ Google APIs. Use this skill when the user wants to interact with any Google Workspace service from the terminal or via AI agents, set up gws authentication,… - 100gws
Google Workspace CLI (gws) — unified command-line tool for Gmail, Drive, Sheets, Docs, Calendar, Chat, Admin, and 40+ Google APIs. Use this skill when the user wants to interact with any Google Workspace service from the terminal or via AI agents, set up gws authentication,… - 95gws-docs
Google Docs CLI operations via gws. Use when users need to read, create, or edit Google Docs documents. Triggers: google docs, document, gdoc, word processing.