Expert in email content extraction and analysis. **Use whenever the user mentions .eml files, email messages, says "Extract email information", "Using the email information", or requests to extract, parse, analyze, or process email files.** Handles email thread parsing, attachment extraction, and converting emails to structured markdown format for AI processing. (project, gitignored)
Expert in email content extraction and analysis. **Use whenever the user mentions .eml files, email messages, says "Extract email information", "Using the email information", or requests to extract, parse, analyze, or process email files.** Handles email thread parsing, attachment extraction, and converting emails to structured markdown format for AI processing. (project, gitignored)
Email Extractor Skill
You are an expert in extracting and analyzing email content from .eml files, converting them to AI-friendly markdown format with proper thread handling and attachment extraction.
⚠️ CRITICAL REQUIREMENT: ALWAYS USE FULL FILE PATHS
YOU MUST ALWAYS use absolute/full paths when working with .eml files.
# Basic extraction (creates folder in .eml's directory)
~/.claude/skills/email-extractor/scripts/email-extractor extract /path/to/message.eml
# Extract to specific output directory
~/.claude/skills/email-extractor/scripts/email-extractor extract ~/Downloads/email.eml -o ~/Documents/extracted
# Get help on available commands
~/.claude/skills/email-extractor/scripts/email-extractor --help
~/.claude/skills/email-extractor/scripts/email-extractor extract --help
Default Output Paths
When no output directory specified:
Email: /path/to/message.eml
Output: /path/to/message_email/ (same directory as .eml)
When custom output directory specified:
Email: /path/to/message.eml
Custom output: /target/
Final output: /target/message_email/ (sanitized subject or filename appended)
Provide results: Summarize email content, list attachments, highlight key information
Clean up: Note extraction location, provide commands for further analysis
Performance & Best Practices
Performance:
Near-instant extraction (compiled binary)
No setup time required
No runtime dependencies
No API calls or external services
Minimal memory footprint
When to use default path: Single emails, permanent archives, files organized alongside .eml files
When to use -o flag: Multiple extractions, analysis projects, separating source and processed files, organizing output in specific directories
Troubleshooting
Common Issues
"Email file not found":
ls -lh /path/to/file.eml
find ~/Downloads -name "*.eml" -type f
"Cannot decode email":
Email might be corrupted
Try opening in email client first
Check file size: ls -lh file.eml
Binary permission issues:
# Make binary executable if neededchmod +x ~/.claude/skills/email-extractor/scripts/email-extractor
# Verify binary works
~/.claude/skills/email-extractor/scripts/email-extractor --help
Integration with Topic Management
This skill integrates with the topic-manager skill:
Trigger Keywords:
User says "Extract email information"
User says "Using the email information"
User says "Update topic [name] with email" or "Update topic [name] using the email"
User mentions .eml files in context of topic updates
Workflow when updating topics with email information:
Invoke email-extractor skill to extract email content and attachments
Upload email.md to topic's Emails folder using google-drive-manager
Upload attachments to appropriate topic folders:
Presentations (PPT, PDF) → Prez folder
Audio/video → Records folder
Other documents → Misc or appropriate location
Extract content from attachments if needed:
Use pdf-extractor for PDFs and presentations
Use speech-to-text for audio/video files
Analyze email content to identify:
Meeting attendees (From, To, Cc fields)
Date and subject
Key decisions and action items
Risks mentioned
Reference email in topic's minutes with link to uploaded email.md
Update topic Google Doc with extracted information
Example Flow:
User: "Update topic 'Q2 Planning' using the email information"
Assistant Process:
1. Search ~/Downloads for .eml file matching "Q2 Planning"
2. Run: email-extractor extract ~/Downloads/q2_planning.eml
3. Review email.md and attachments
4. Upload email.md to topic's Emails folder
5. Process any attachments (extract PDFs, etc.)
6. Update topic with extracted information
