Email Drafting Skill
Config — read before starting
Read ../config/user.json (resolves to ~/executive-assistant-skills/config/user.json).
Extract and use throughout:
primary_email, work_email — Gmail accounts
scheduling_cc — scheduling assistant email (CC on all scheduling emails, mention in body)
scheduling_silent_cc — silent CC for scheduling visibility (do NOT mention in email body)
signature — sign-off for all drafts (e.g. "--gonto")
name — short name for context
Do not proceed until you have these values.
Debug Logging (MANDATORY)
Read ../config/DEBUG_LOGGING.md for the full convention. Use python3 {user.workspace}/scripts/skill_log.py email-drafting <level> "<message>" ['<details>'] at every key step. Log BEFORE and AFTER every external call (gog gmail, mcporter, todoist-cli). On any error, log the full command and stderr before continuing.
Overview
Auto-draft and manually-requested email drafts for {user.primary_email} and {user.work_email}.
When to Use
- Gmail hook detects a trigger (intro, scheduling, thanks/ack, positive reply)
- User asks to draft/reply/send an email
- Action items cron identifies email follow-ups needed
Architecture
- Detects triggers and creates Gmail drafts
- Handles all scheduling (slot-finding, conflict checking, calendar ops)
- NEVER proposes specific dates/times or creates calendar events
Execution
- "Reply" always means Reply All — include all original To + CC recipients. Only exclude if user explicitly says to reply to one person. Exception: intro handling moves the introducer to BCC per the intro sequence below.
- After sending any email/draft, check if it fulfills an open Todoist task (send deck, intro, follow-up, etc.). If yes → complete the task immediately and confirm.
- Hook/cron triggers: Always run via isolated sub-agent (prevents memory/context contamination)
- Direct user requests ("draft a reply to X"): Main agent may execute directly, but must still follow all style rules and must NOT read MEMORY.md or daily memory files
Rules (non-negotiable)
Core
- Draft-only mode — never send automatically
- Mirror inbound language — match the language of the most recent non-automated message in the thread. If the thread has mixed languages, default to the language of the message you're replying to.
- Always sign — end every draft with
{user.signature}
- Low confidence — don't draft; ask user for guidance
- No dash punctuation — no em-dash/en-dash in bodies. Use commas/periods.
- Humanize — before finalizing any draft, review it against
~/executive-assistant-skills/humanizer/SKILL.md. Remove AI-writing markers: inflated symbolism, promotional tone, em-dash overuse, "delve"/"leverage"/"foster" vocabulary, rule-of-three patterns. Email-specific rules (no dashes, signature, brevity) take precedence over humanizer suggestions if they conflict.
Intro Handling (required sequence)
- Thank introducer first
- Move introducer to BCC
- Reply to introduced contact directly
- CC
{user.scheduling_cc} and {user.scheduling_silent_cc} for scheduling
- Include one line like: "Connecting {user.scheduling_cc_name} to find a time."
- Do NOT mention
{user.scheduling_silent_cc} in the email body — silent CC only
Scheduling Drafts
- ALWAYS CC {user.scheduling_cc} AND {user.scheduling_silent_cc}
- NEVER propose specific dates or times
- Just confirm willingness to meet + mention scheduling assistant will coordinate
- Example: "Connecting Alfred to find a time that works"
- Do NOT mention {user.scheduling_silent_cc} in the email body — she's CC'd silently for visibility
Allowed Auto-Draft Classes
- Thanks/ack
- Scheduling intent
- Positive short replies
- Intro acceptance
Notification Format
account + one-line intent + draft link
- Example:
📧 Draft ({user.primary_email} → John): intro acceptance. https://mail.google.com/...
Draft Links
After creating a draft via gog, extract the draft ID from the response.
Gmail draft URL format: https://mail.google.com/mail/u/?authuser={account_email}#drafts?compose={message_id}
Use authuser=m@gon.to or authuser=gonto@hypergrowthpartners.com as appropriate.
Trigger Detection
A) Intro
- Cues:
intro, introduction, meet, connecting you, looping in, cc'ing
- At least 2 external participants + clear handoff language
- Apply intro sequence exactly
B) Scheduling Intent
- Cues:
find a time, schedule, availability, next week, calendar
- Spanish cues:
agendar, agenda una, tenés unos minutos
- CC scheduling contacts, don't propose times
C) Thanks/Ack
- Cues:
thanks, got it, appreciate it, status updates
- Short acknowledgment + optional one-line next step
D) Positive Short Reply
- Cues:
works for me, sounds good, perfect, great
- Short affirmative + close
Skip Conditions (do NOT auto-draft)
- Confidence low / intent ambiguous
- User already replied in the thread (SENT message exists)
- Legal, financial, security, hiring-final, sensitive conflict topics
- Multi-question strategic asks
- Automated/system/calendar notifications
- Messages requiring attachments, deep verification, or policy commitments
- Language unclear or unmirrorable
- Scheduling confirmations — NEVER auto-draft emails that simply confirm a scheduled time or acknowledge a calendar invite. The scheduling assistant (Alfred/Howie) handles all scheduling coordination. Auto-drafting "confirming our call at X" creates noise and duplicates the scheduler's work. This includes: confirming times proposed by the scheduler, acknowledging calendar invites, and "looking forward to our call" type replies to scheduling threads.
Confidence Gate
Only auto-draft when ALL are true:
- Trigger class is one of the 4 allowed
- Language confidently detected and mirrorable
- Clear recipient intent and next step
- No skip condition present
Otherwise: ask user.
Drafting Principles
- Keep it SHORT — drafts are always brief. 2-3 short paragraphs max.
- No over-explaining — state the point, don't elaborate unless necessary
- When promising intros: before drafting the intro, search sent emails for previous intros to that person/company, copy the format and tone, and use the same email address
- When recommending a person/company: use your own words from past emails about them rather than inventing new descriptions
- Deck/one-pager: say "Hypergrowth Partners deck" (not "our one-pager" or "our deck"). When attaching, frame WHY it's useful (e.g. "where we explain what Hypergrowth is and how we help companies")
- Future availability: frame as an opportunity, not a brush-off. Position it warmly: "I'd love to reconnect then to explore working together if the timing still makes sense" rather than blunt "let's connect closer to June"
- Offers of help should use meeting context: read Granola notes from the call and reference specific things discussed. The draft should feel like it came from someone who was in the meeting.
- No generic "Great meeting today" unless it's explicitly a first meeting (first VC call or first dealflow call).
- Proposal-first rule: if the commitment is to build/provide a proposal first, do not draft outbound email yet; create TODO only.
Use Grain as primary source for meeting-based drafts
When drafting follow-up emails from meetings, Grain transcript is the primary source (not Granola):
- Find the meeting in Grain:
mcporter call grain.list_attended_meetings --args '{"limit": 5}'
- Fetch transcript:
mcporter call grain.fetch_meeting_transcript --args '{"meeting_id": "<id>"}'
- Search transcript for email commitments: "I'll send", "I'll email", "I'll share", "let me intro", "I'll follow up", "I'll connect you", etc.
- Draft from the transcript — use your actual words and the real conversation context, not Granola's summary.
- Fall back to Granola only if Grain has no recording for that meeting.
Style
Read {user.workspace}/style/EMAIL_STYLE.md for the full writing style guide (derived from 200+ real sent emails).
Read {user.workspace}/style/FEEDBACK_LOG.md for user corrections — latest overrides win.
Key points:
- Friendly, concise, action-oriented. Warm but not fluffy.
- 1–4 short paragraphs, ~6–7 word sentences
- Context-first openings, straight to point
- Common opens: "Hey ,", "Thanks…", "Perfect…", "Great…"
- Sign off:
{user.signature}
- No dash punctuation (no em-dash/en-dash)
- Do: be brief, clear, warm, decisive, include draft link in notification
- Don't: over-explain, corporate fluff, long formal prose
Templates
- Primary:
{user.workspace}/style/EMAIL_TEMPLATES.md — pattern templates (intros, follow-ups, VC, etc.)
- Legacy (HGP v1):
{user.workspace}/style/email-templates.md — HGP business templates. Use only for HGP-specific business contexts. Primary templates take precedence on conflicts.
Audit Logging (MANDATORY)
After every external action, log it:
- Draft created:
python3 {user.workspace}/scripts/audit_log.py log email_drafted "<recipient>" success '{"account": "<account>", "subject": "<subject>", "type": "<trigger_class>"}'
- Email sent:
python3 {user.workspace}/scripts/audit_log.py log email_sent "<recipient>" success '{"account": "<account>", "subject": "<subject>"}'
- Draft skipped (low confidence):
python3 {user.workspace}/scripts/audit_log.py log email_draft_skipped "<recipient>" skipped '{"reason": "<reason>"}'
Auto-Draft Constraints
- NEVER create calendar events — only the scheduling assistant handles that
- Only create email drafts
- Include
--to <sender> explicitly when creating drafts
Auto-Draft WhatsApp Notification (MANDATORY)
Every time a draft is created automatically (via Gmail hook or any automated trigger), you MUST send a WhatsApp notification to {user.whatsapp} with:
✏️ *Auto-draft created*
*To:* <recipient name> (<email>)
*Subject:* <subject>
*Account:* <account>
*Trigger:* <intro/scheduling/thanks/positive reply>
*Draft text:*
> <full draft body — include the complete text so user can review without opening Gmail>
🔗 <Gmail draft link>
Reply "send" to send, or edit in Gmail.
This is non-optional. The user must be able to read and approve the draft from WhatsApp without opening Gmail.
Notification Policy
- No routine "no change" notifications
- Alert on: meaningful changes, breakages, time-sensitive items, auto-drafted emails
- Time-sensitive: approvals, meeting changes, 2FA codes, security, travel changes
- Evaluate Promotions, suppress Spam/Junk/Trash
Prerequisites
gog CLI configured with both Gmail accounts (primary and work)
mcporter with Grain MCP connection for meeting transcript access
- OpenClaw workspace with
skill_log.py and audit_log.py scripts
- Email style guide at
{user.workspace}/style/EMAIL_STYLE.md
- Humanizer skill at
~/executive-assistant-skills/humanizer/SKILL.md
Instructions
See the Execution, Trigger Detection, and Drafting Principles sections above for the full workflow. The skill detects trigger class (intro, scheduling, thanks/ack, positive reply), applies confidence gate, drafts via gog, and notifies via WhatsApp.
Output
- Gmail draft created on the correct account (never sent automatically)
- WhatsApp notification with full draft text, Gmail draft link, and trigger class
- Audit log entry for each draft created, sent, or skipped
Error Handling
See the Skip Conditions and Confidence Gate sections above. Low-confidence triggers are not drafted. Errors in external calls (gog, mcporter) are logged via skill_log.py before continuing.
Examples
# Auto-draft trigger: intro email detected in inbox
# Output: Gmail draft with intro acceptance, introducer moved to BCC,
# scheduling assistant CC'd, WhatsApp notification with full draft text
# "Draft (m@gon.to -> John): intro acceptance. [Gmail link]"
Resources
1---
2name: email-drafting
3description: "Draft email replies for Gonto's Gmail accounts (m@gon.to, gonto@hypergrowthpartners.com).\
4 \ Handles intro acceptances, scheduling intent, thanks/ack, and positive short replies.\
5 \ Use when user asks to draft or reply to an email, or when Gmail webhook triggers\
6 \ arrive for auto-draft classification. Draft-only mode \u2014 never sends automatically."
7version: 1.8.0
8license: MIT
9author: Martin Gontovnikas <martin@hypergrowthpartners.com>
10tags:
11- business
12- webhooks
13- email-drafting
14allowed-tools: Read, Bash(gog:*), Bash(mcporter:*), Bash(python3:*), Glob, Grep, Write
15compatibility: Designed for Claude Code
16---
17
18# Email Drafting Skill
19
20## Config — read before starting
21
22Read `../config/user.json` (resolves to `~/executive-assistant-skills/config/user.json`).
23Extract and use throughout:
24
25- `primary_email`, `work_email` — Gmail accounts
26- `scheduling_cc` — scheduling assistant email (CC on all scheduling emails, mention in body)
27- `scheduling_silent_cc` — silent CC for scheduling visibility (do NOT mention in email body)
28- `signature` — sign-off for all drafts (e.g. "--gonto")
29- `name` — short name for context
30
31Do not proceed until you have these values.
32
33## Debug Logging (MANDATORY)
34
35Read `../config/DEBUG_LOGGING.md` for the full convention. Use `python3 {user.workspace}/scripts/skill_log.py email-drafting <level> "<message>" ['<details>']` at every key step. Log BEFORE and AFTER every external call (gog gmail, mcporter, todoist-cli). On any error, log the full command and stderr before continuing.
36
37## Overview
38
39Auto-draft and manually-requested email drafts for {user.primary_email} and {user.work_email}.
40
41## When to Use
42
43- Gmail hook detects a trigger (intro, scheduling, thanks/ack, positive reply)
44- User asks to draft/reply/send an email
45- Action items cron identifies email follow-ups needed
46
47## Architecture
48
49- Detects triggers and creates Gmail drafts
50- Handles all scheduling (slot-finding, conflict checking, calendar ops)
51- NEVER proposes specific dates/times or creates calendar events
52
53## Execution
54
55- **"Reply" always means Reply All** — include all original To + CC recipients. Only exclude if user explicitly says to reply to one person. Exception: intro handling moves the introducer to BCC per the intro sequence below.
56- **After sending any email/draft**, check if it fulfills an open Todoist task (send deck, intro, follow-up, etc.). If yes → complete the task immediately and confirm.
57- **Hook/cron triggers**: Always run via isolated sub-agent (prevents memory/context contamination)
58- **Direct user requests** ("draft a reply to X"): Main agent may execute directly, but must still follow all style rules and must NOT read MEMORY.md or daily memory files
59
60## Rules (non-negotiable)
61
62### Core
63
641. **Draft-only mode** — never send automatically
652. **Mirror inbound language** — match the language of the most recent non-automated message in the thread. If the thread has mixed languages, default to the language of the message you're replying to.
663. **Always sign** — end every draft with `{user.signature}`
674. **Low confidence** — don't draft; ask user for guidance
685. **No dash punctuation** — no em-dash/en-dash in bodies. Use commas/periods.
696. **Humanize** — before finalizing any draft, review it against `~/executive-assistant-skills/humanizer/SKILL.md`. Remove AI-writing markers: inflated symbolism, promotional tone, em-dash overuse, "delve"/"leverage"/"foster" vocabulary, rule-of-three patterns. Email-specific rules (no dashes, signature, brevity) take precedence over humanizer suggestions if they conflict.
70
71### Intro Handling (required sequence)
72
731. Thank introducer first
742. Move introducer to BCC
753. Reply to introduced contact directly
764. CC `{user.scheduling_cc}` and `{user.scheduling_silent_cc}` for scheduling
775. Include one line like: "Connecting {user.scheduling_cc_name} to find a time."
786. **Do NOT mention `{user.scheduling_silent_cc}` in the email body** — silent CC only
79
80### Scheduling Drafts
81
82- **ALWAYS CC {user.scheduling_cc} AND {user.scheduling_silent_cc}**
83- **NEVER propose specific dates or times**
84- Just confirm willingness to meet + mention scheduling assistant will coordinate
85- Example: "Connecting Alfred to find a time that works"
86- **Do NOT mention {user.scheduling_silent_cc} in the email body** — she's CC'd silently for visibility
87
88### Allowed Auto-Draft Classes
89
90- Thanks/ack
91- Scheduling intent
92- Positive short replies
93- Intro acceptance
94
95### Notification Format
96
97- `account + one-line intent + draft link`
98- Example: `📧 Draft ({user.primary_email} → John): intro acceptance. https://mail.google.com/...`
99
100## Draft Links
101
102After creating a draft via `gog`, extract the draft ID from the response.
103Gmail draft URL format: `https://mail.google.com/mail/u/?authuser={account_email}#drafts?compose={message_id}`
104Use `authuser=m@gon.to` or `authuser=gonto@hypergrowthpartners.com` as appropriate.
105
106## Trigger Detection
107
108### A) Intro
109
110- Cues: `intro`, `introduction`, `meet`, `connecting you`, `looping in`, `cc'ing`
111- At least 2 external participants + clear handoff language
112- Apply intro sequence exactly
113
114### B) Scheduling Intent
115
116- Cues: `find a time`, `schedule`, `availability`, `next week`, `calendar`
117- Spanish cues: `agendar`, `agenda una`, `tenés unos minutos`
118- CC scheduling contacts, don't propose times
119
120### C) Thanks/Ack
121
122- Cues: `thanks`, `got it`, `appreciate it`, status updates
123- Short acknowledgment + optional one-line next step
124
125### D) Positive Short Reply
126
127- Cues: `works for me`, `sounds good`, `perfect`, `great`
128- Short affirmative + close
129
130## Skip Conditions (do NOT auto-draft)
131
132- Confidence low / intent ambiguous
133- User already replied in the thread (SENT message exists)
134- Legal, financial, security, hiring-final, sensitive conflict topics
135- Multi-question strategic asks
136- Automated/system/calendar notifications
137- Messages requiring attachments, deep verification, or policy commitments
138- Language unclear or unmirrorable
139- **Scheduling confirmations** — NEVER auto-draft emails that simply confirm a scheduled time or acknowledge a calendar invite. The scheduling assistant (Alfred/Howie) handles all scheduling coordination. Auto-drafting "confirming our call at X" creates noise and duplicates the scheduler's work. This includes: confirming times proposed by the scheduler, acknowledging calendar invites, and "looking forward to our call" type replies to scheduling threads.
140
141## Confidence Gate
142
143Only auto-draft when ALL are true:
144
145- Trigger class is one of the 4 allowed
146- Language confidently detected and mirrorable
147- Clear recipient intent and next step
148- No skip condition present
149
150Otherwise: ask user.
151
152## Drafting Principles
153
154- **Keep it SHORT** — drafts are always brief. 2-3 short paragraphs max.
155- **No over-explaining** — state the point, don't elaborate unless necessary
156- **When promising intros**: before drafting the intro, search sent emails for previous intros to that person/company, copy the format and tone, and use the same email address
157- **When recommending a person/company**: use your own words from past emails about them rather than inventing new descriptions
158- **Deck/one-pager**: say "Hypergrowth Partners deck" (not "our one-pager" or "our deck"). When attaching, frame WHY it's useful (e.g. "where we explain what Hypergrowth is and how we help companies")
159- **Future availability**: frame as an opportunity, not a brush-off. Position it warmly: "I'd love to reconnect then to explore working together if the timing still makes sense" rather than blunt "let's connect closer to June"
160- **Offers of help should use meeting context**: read Granola notes from the call and reference specific things discussed. The draft should feel like it came from someone who was in the meeting.
161- **No generic "Great meeting today"** unless it's explicitly a first meeting (first VC call or first dealflow call).
162- **Proposal-first rule**: if the commitment is to build/provide a proposal first, do not draft outbound email yet; create TODO only.
163
164## Use Grain as primary source for meeting-based drafts
165
166When drafting follow-up emails from meetings, **Grain transcript is the primary source** (not Granola):
167
1681. Find the meeting in Grain: `mcporter call grain.list_attended_meetings --args '{"limit": 5}'`
1692. Fetch transcript: `mcporter call grain.fetch_meeting_transcript --args '{"meeting_id": "<id>"}'`
1703. Search transcript for email commitments: "I'll send", "I'll email", "I'll share", "let me intro", "I'll follow up", "I'll connect you", etc.
1714. **Draft from the transcript** — use your actual words and the real conversation context, not Granola's summary.
1725. Fall back to Granola only if Grain has no recording for that meeting.
173
174## Style
175
176Read `{user.workspace}/style/EMAIL_STYLE.md` for the full writing style guide (derived from 200+ real sent emails).
177Read `{user.workspace}/style/FEEDBACK_LOG.md` for user corrections — latest overrides win.
178
179Key points:
180
181- Friendly, concise, action-oriented. Warm but not fluffy.
182- 1–4 short paragraphs, ~6–7 word sentences
183- Context-first openings, straight to point
184- Common opens: "Hey <Name>,", "Thanks…", "Perfect…", "Great…"
185- Sign off: `{user.signature}`
186- No dash punctuation (no em-dash/en-dash)
187- **Do:** be brief, clear, warm, decisive, include draft link in notification
188- **Don't:** over-explain, corporate fluff, long formal prose
189
190## Templates
191
192- **Primary**: `{user.workspace}/style/EMAIL_TEMPLATES.md` — pattern templates (intros, follow-ups, VC, etc.)
193- **Legacy (HGP v1)**: `{user.workspace}/style/email-templates.md` — HGP business templates. Use only for HGP-specific business contexts. Primary templates take precedence on conflicts.
194
195## Audit Logging (MANDATORY)
196
197After every external action, log it:
198
199- **Draft created**: `python3 {user.workspace}/scripts/audit_log.py log email_drafted "<recipient>" success '{"account": "<account>", "subject": "<subject>", "type": "<trigger_class>"}'`
200- **Email sent**: `python3 {user.workspace}/scripts/audit_log.py log email_sent "<recipient>" success '{"account": "<account>", "subject": "<subject>"}'`
201- **Draft skipped** (low confidence): `python3 {user.workspace}/scripts/audit_log.py log email_draft_skipped "<recipient>" skipped '{"reason": "<reason>"}'`
202
203## Auto-Draft Constraints
204
205- **NEVER create calendar events** — only the scheduling assistant handles that
206- Only create email drafts
207- Include `--to <sender>` explicitly when creating drafts
208
209## Auto-Draft WhatsApp Notification (MANDATORY)
210
211Every time a draft is created automatically (via Gmail hook or any automated trigger), you MUST send a WhatsApp notification to {user.whatsapp} with:
212
213```
214✏️ *Auto-draft created*
215
216*To:* <recipient name> (<email>)
217*Subject:* <subject>
218*Account:* <account>
219*Trigger:* <intro/scheduling/thanks/positive reply>
220
221*Draft text:*
222> <full draft body — include the complete text so user can review without opening Gmail>
223
224🔗 <Gmail draft link>
225
226Reply "send" to send, or edit in Gmail.
227```
228
229This is non-optional. The user must be able to read and approve the draft from WhatsApp without opening Gmail.
230
231## Notification Policy
232
233- No routine "no change" notifications
234- Alert on: meaningful changes, breakages, time-sensitive items, **auto-drafted emails**
235- Time-sensitive: approvals, meeting changes, 2FA codes, security, travel changes
236- Evaluate Promotions, suppress Spam/Junk/Trash
237
238## Prerequisites
239
240- `gog` CLI configured with both Gmail accounts (primary and work)
241- `mcporter` with Grain MCP connection for meeting transcript access
242- OpenClaw workspace with `skill_log.py` and `audit_log.py` scripts
243- Email style guide at `{user.workspace}/style/EMAIL_STYLE.md`
244- Humanizer skill at `~/executive-assistant-skills/humanizer/SKILL.md`
245
246## Instructions
247
248See the Execution, Trigger Detection, and Drafting Principles sections above for the full workflow. The skill detects trigger class (intro, scheduling, thanks/ack, positive reply), applies confidence gate, drafts via `gog`, and notifies via WhatsApp.
249
250## Output
251
252- Gmail draft created on the correct account (never sent automatically)
253- WhatsApp notification with full draft text, Gmail draft link, and trigger class
254- Audit log entry for each draft created, sent, or skipped
255
256## Error Handling
257
258See the Skip Conditions and Confidence Gate sections above. Low-confidence triggers are not drafted. Errors in external calls (gog, mcporter) are logged via `skill_log.py` before continuing.
259
260## Examples
261
262```bash
263# Auto-draft trigger: intro email detected in inbox
264# Output: Gmail draft with intro acceptance, introducer moved to BCC,
265# scheduling assistant CC'd, WhatsApp notification with full draft text
266# "Draft (m@gon.to -> John): intro acceptance. [Gmail link]"
267```
268
269## Resources
270
271- [Gmail API](https://developers.google.com/gmail/api)
272- Grain API
273- [Gmail Draft URL format](https://mail.google.com/mail/u/?authuser={email}#drafts)