name: email-composer
description: |
Compose and send individual emails. Use this skill when the user wants to write a new email
to a single recipient (not bulk/campaign). Supports templates and attachments.
allowed-tools:
- Bash
- Read
- Write
- TodoWrite
- AskUserQuestion

10x Email Composer Skill

Compose and send individual emails with preview and approval.

When to Use This Skill

Use this skill when the user:
- Wants to compose a new email
- Asks to send an email to someone
- Needs to write a single email (not bulk)
- Wants to create an email draft

When NOT to Use This Skill

Do NOT use this skill for:
- Bulk/campaign emails → use outreach-manager
- Replying to emails → use reply-generator
- Reading emails → use inbox-reader

Capabilities

1. Compose Emails - Write new emails from scratch
2. Use Templates - Apply templates with personalization
3. Attachments - Support file attachments
4. HTML Emails - Send formatted HTML emails
5. Preview - Always preview before sending
6. Save Draft - Save to Gmail drafts

CRITICAL: 3-Mode Workflow with TodoWrite

Mode 1: PLAN

Start with TodoWrite:

[
  {"content": "Gather email details (to, subject, content)", "status": "in_progress", "activeForm": "Gathering details"},
  {"content": "Create email draft", "status": "pending", "activeForm": "Creating draft"},
  {"content": "Preview email to user", "status": "pending", "activeForm": "Previewing email"},
  {"content": "Get user approval", "status": "pending", "activeForm": "Getting approval"},
  {"content": "Send email", "status": "pending", "activeForm": "Sending email"}
]

Gather required information:
- To: (recipient email)
- Subject: (email subject)
- Body: (email content)
- Template: (optional)
- Attachments: (optional)

Mode 2: CLARIFY

Ask for missing information:
- "Who should I send this email to?"
- "What's the subject?"
- "What would you like to say?"
- "Do you want to use a template?"

Mode 3: IMPLEMENT

Preview First:

Present the complete email to user:

📧 Email Preview:

To: [email protected]
Subject: Your Subject Here

Body:
[Full email content]

---
Send this email?

Only After Approval - Send:

python .claude/scripts/gmail_client.py send --to "[email protected]" --subject "Subject" --body "Email body here"

Save as Draft:

python .claude/scripts/gmail_client.py draft --to "[email protected]" --subject "Subject" --body "Email body here"

Using Templates

List Available Templates:

python .claude/scripts/template_loader.py list --platform email

Render a Template:

python .claude/scripts/template_loader.py render --path email/outreach/warm_intro --var first_name "John" --var company "Acme"

Templates support variables:
- {{ name }} - Recipient name
- {{ company }} - Company name
- {{ custom_message }} - Custom content

Example Workflow

User: "Send an email to [email protected] about the project update"

Step 1: Create Todo List

[
  {"content": "Compose email to [email protected]", "status": "in_progress", "activeForm": "Composing email"},
  {"content": "Preview draft to user", "status": "pending", "activeForm": "Previewing draft"},
  {"content": "Get user approval", "status": "pending", "activeForm": "Getting approval"},
  {"content": "Send email", "status": "pending", "activeForm": "Sending email"}
]

Step 2: Draft the email
Ask user for content or help compose it.

Step 3: Preview

📧 Email Preview:

To: [email protected]
Subject: Project Update

Hi John,

Here's the latest update on the project...

Best regards,
[Your Name]

---
Does this look good? Send, edit, or save as draft?

Step 4: Approval
Wait for explicit "yes" / "send" / approval.

Step 5: Send
Execute send command and confirm success.

With HTML Content

python .claude/scripts/gmail_client.py send --to "[email protected]" --subject "Subject" --body "Plain text version" --html "<h1>HTML Version</h1><p>With formatting</p>"

With Attachments

python .claude/scripts/gmail_client.py send --to "[email protected]" --subject "Subject with attachment" --body "Please find attached." --attachment "path/to/file.pdf"

Safety Rules

1. Always preview before sending
2. Get explicit approval before send
3. Offer draft option as alternative
4. Log sent emails to output/sent/
5. Validate email addresses before sending