Skip to content
Skills Library
Documents & office · Writing

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.

Repository
ai-helpers ↗
Licence
Apache-2.0
Last repository change
22.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 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

  1. Prerequisites
  2. Step 1: Gather Recipients, Subject, and Body
  3. Step 2: Present for Review
  4. Step 3: Create the Draft
  5. Step 4: Confirm
  6. Error Reference
Original SKILL.md headings · 90 lines, 347 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.