Skill: send-email

Internal service skill for sending project emails via Gmail MCP. Called exclusively by other agent skills — not directly by the user. Receives a rendered email from the calling skill, applies autonomy level rules, converts attachments if needed, and delivers via Gmail or saves a fallback draft.

Activation Context

This skill is activated when another agent skill instructs Claude to send an email. The calling skill provides all content; send-email handles delivery, autonomy logic, and fallback.

Calling skills: generate-questionnaire, generate-approval-letter, monitor-progress, coordinate-meeting, coordinate-executors.

Language Detection

Determine language from project-state.md field language. If absent: scan project artifacts for Cyrillic → RU. Default: EN.

Input

Parameters passed by the calling skill:

Output

Instructions

Step 1 — Guard-rail

If called directly by a user (not as part of a skill chain): Detection: input is natural language without structured parameters — at least one of email_type, to, subject, body_md, autonomy_level is absent. Respond: "send-email is an internal service skill activated automatically during email delivery. To send a project email, trigger the relevant skill (e.g., coordinate-executors for reminders, generate-approval-letter for approvals)."

Caller contract (for calling skills): body_md MUST be fully rendered Markdown text — not a file path, template variable, or reference. The calling skill is responsible for loading its own template from templates/, populating all placeholders, and passing the result as a string. send-email has no templates/ folder of its own.

Step 2 — Validate Parameters

1. Check required fields: email_type, to, subject, body_md, autonomy_level.
   • If any field is missing → ask PM for the missing data.
2. If email_type is unknown or outside E1–E8 → default to autonomy level 3.
3. Read project-state.md: get pm_email, project_name, language.

Step 3 — Convert Attachments

If attachments is set AND convert_to_docx = true:

• Level 1/2: convert here, before sending.
• Level 3: defer conversion until PM confirms — perform at the start of Step 5.

For each file (when converting):

• .md files → convert via Cowork docx skill → produce .docx (same filename).
• .xlsx files → use as-is.
• Other formats → attach as-is, warn PM in chat.
• On conversion error → log error, attach original .md, notify PM.

Step 4 — Apply Autonomy Level

Level 3 flow:

1. Save draft to drafts/email-draft-{email_type}-{YYYY-MM-DD}.md.
2. Display in chat:

   Draft ready ({email_type}):
   — To: {to}
   — Subject: {subject}
   — Attachments: {list or "none"}
   [body preview: first 5 lines or full if < 15 lines]
   
   Confirm: type "send" / "отправить" — or provide edits.

3. Wait for PM response:
   • "send", "отправить", "confirm", "подтвердить" → proceed to Step 5.
   • Edit text → apply changes, update draft, show again.
   • "cancel", "отмена" → log "cancelled by PM", end skill.

Step 5 — Send via Gmail MCP

Primary path (Gmail available):

Call Gmail MCP:

• to: recipient list from to parameter
• subject: from subject parameter
• body: body_md content
• cc: PM email (Level 2 only) or empty
• attachments: converted files (if any)

On success → proceed to Step 6.

Fallback (Gmail unavailable or MCP error):

1. Save draft to drafts/email-draft-{email_type}-{YYYY-MM-DD}.md (for levels 1/2 this is the first time the draft is created; for level 3 it is overwritten). Use format from the Email Type Registry section: header (To, Subject, CC, Attachments) + body + attachment paths.

   # Email Draft: {email_type}
   Date: {YYYY-MM-DD}
   To: {to}
   Subject: {subject}
   CC: {cc or "—"}
   Attachments: {list or "—"}
   ---
   {body_md}

2. Notify PM: "Gmail unavailable. Draft saved at drafts/email-draft-{email_type}-{YYYY-MM-DD}.md. Please send manually."
3. Proceed to Step 6.

Step 6 — Log

Write to logs/log.md:

• Sent: {DATE}: send-email — sent {email_type} → {to} (level {N})
• Fallback: {DATE}: send-email — fallback, draft saved drafts/email-draft-{type}-{DATE}.md
• Cancelled: {DATE}: send-email — cancelled by PM, {email_type} not sent

Email Type Registry

Constraints

• Does NOT generate email content — receives rendered content from calling skill
• Does NOT select recipients — set by calling skill
• Does NOT update project-state.md — updated by calling skill
• Mass send (>10 recipients) requires explicit PM confirmation regardless of level
• Level 3 draft awaits confirmation within the current session; if session closes, draft remains in drafts/
• Direct user invocation is not supported