Skip to content
Back to search

claude-email

SkillWorks with Claude CodeGitHub

AI-powered email management and marketing skill for Claude Code. Inbox triage, composition, quality review, deliverability audit, automation sequences, and marketing strategy.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/agricidaniel-claude-email/badge.svg)](/listings/agricidaniel-claude-email)

HTML

<a href="/listings/agricidaniel-claude-email"><img src="/api/listings/agricidaniel-claude-email/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.sh | bash

After installation, run `/email` in Claude Code to start the interactive wizard.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 272 lines · 4 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/header.jpeg" alt="Claude Email — AI-Powered Email Management" width="100%">
  3. </p>
  4. # Claude Email — AI-Powered Email Management and Marketing
  5. > Professional email management, deliverability optimization, and marketing strategy powered by Claude Code
  6. **6 sub-skills** | **4 agents** | **3 scripts** | **MIT License**
  7. ---
  8. ## Features
  9. - **Inbox Triage**: AI importance scoring, smart labeling, and contextual reply suggestions via Gmail/Outlook MCP
  10. - **Email Composition**: Proven copywriting frameworks (PAS, AIDA, BAB, FAB, 4Ps) with tone/voice matching
  11. - **Pre-Send Review**: 0-100 quality scoring across clarity, professionalism, CTA strength, tone, and technical quality
  12. - **Deliverability Audit**: SPF/DKIM/DMARC validation, blacklist monitoring, bulk sender compliance (Google/Yahoo/Microsoft 2024-2026)
  13. - **Automation Sequences**: Welcome series, nurture flows, re-engagement, abandoned cart, post-purchase drips
  14. - **Marketing Strategy**: Industry-specific templates with 90-day roadmap, KPI targets, and content calendars
  15. - **User Profiles**: Adaptive system learns your business type, platform, brand voice, and preferences
  16. ---
  17. ## Quick Start
  18. ```bash
  19. curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 28 on GitHub
  20. ```
  21. After installation, run `/email` in Claude Code to start the interactive wizard.
  22. ---
  23. ## Commands
  24. | Command | Description |
  25. |---------|-------------|
  26. | `/email` | Interactive mode with skill selection menu |
  27. | `/email check` | Inbox triage with importance scoring and reply suggestions |
  28. | `/email write` | Compose email using copywriting frameworks |
  29. | `/email review` | Quality review with 0-100 scoring and improvement suggestions |
  30. | `/email audit <domain>` | Deliverability audit (SPF/DKIM/DMARC, blacklists, compliance) |
  31. | `/email sequence <type>` | Design automation sequence (welcome, nurture, cart, etc.) |
  32. | `/email plan <business>` | Marketing strategy with 90-day roadmap |
  33. ---
  34. ## MCP Integration
  35. Claude Email integrates with email platforms via MCP servers:
  36. ### Required (for inbox features)
  37. - **Gmail**: [taylorwilsdon/google_workspace_mcp](https://github.com/taylorwilsdon/google_workspace_mcp)
  38. - **Microsoft 365**: [Softeria/ms-365-mcp-server](https://github.com/Softeria/ms-365-mcp-server)
  39. ### Optional (for advanced features)
  40. - **SendGrid**: [Garoth/sendgrid-mcp](https://github.com/Garoth/sendgrid-mcp) - Transactional email analytics
  41. - **Mailchimp**: Campaign management and automation
  42. - **Kit.com** (ConvertKit): Creator-focused email marketing
  43. At least one inbox MCP (Gmail or Outlook) is required for `/email check`. All other features work standalone.
  44. ---
  45. ## Architecture
  46. ```
  47. claude-email/
  48. ├── email/SKILL.md # Main orchestrator
  49. ├── skills/
  50. │ ├── email-check/SKILL.md # Inbox triage
  51. │ ├── email-write/SKILL.md # Composition
  52. │ ├── email-review/SKILL.md # Quality review
  53. │ ├── email-audit/SKILL.md # Deliverability
  54. │ ├── email-sequence/SKILL.md # Automation design
  55. │ └── email-plan/SKILL.md # Marketing strategy
  56. ├── agents/
  57. │ ├── email-deliverability.md # Technical validation
  58. │ ├── email-compliance.md # Legal/regulatory checks
  59. │ ├── email-content.md # Copywriting analysis
  60. │ └── email-inbox.md # Triage logic
  61. ├── scripts/
  62. │ ├── check_deliverability.py # SPF/DKIM/DMARC validation
  63. │ ├── analyze_email_html.py # HTML quality scoring
  64. │ └── score_subject_line.py # Subject line analysis
  65. ├── email/references/
  66. │ ├── deliverability-rules.md # DNS, authentication, reputation
  67. │ ├── benchmarks.md # Industry metrics
  68. │ ├── compliance.md # CAN-SPAM, GDPR, CASL
  69. │ ├── copy-frameworks.md # PAS, AIDA, BAB, FAB, 4Ps
  70. │ ├── technical-standards.md # HTML, rendering, accessibility
  71. │ └── mcp-integration.md # Platform-specific guides
  72. ├── skills/email-plan/assets/
  73. │ ├── local-business.md # Local/service business strategy
  74. │ ├── saas.md # SaaS strategy
  75. │ ├── ecommerce.md # E-commerce strategy
  76. │ ├── creator.md # Creator/influencer strategy
  77. │ ├── agency.md # Agency/B2B strategy
  78. │ └── generic.md # General business strategy
  79. └── hooks/
  80. ├── pre-send-check.sh # Pre-send validation hook
  81. └── validate-email-html.py # HTML quality gate
  82. ```
  83. ---
  84. ## Requirements
  85. - **Claude Code CLI** (latest version)
  86. - **Python 3.10+** (for deliverability scripts)
  87. - **Gmail MCP** or **Outlook MCP** (for inbox triage features)
  88. - **Optional**: `checkdmarc` Python package for advanced DNS validation
  89. ---
  90. ## Installation
  91. ### Unix/macOS (bash)
  92. ```bash
  93. curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 121 on GitHub
  94. ```
  95. ### Windows (PowerShell)
  96. ```powershell
  97. irm https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.ps1 | iex
  98. ```
  99. ### Manual Installation
  100. ```bash
  101. git clone https://github.com/AgriciDaniel/claude-email.git
  102. cd claude-email
  103. chmod +x install.sh
  104. ./install.sh
  105. ```
  106. ---
  107. ## Uninstall
  108. ```bash
  109. curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/uninstall.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 142 on GitHub
  110. ```
  111. ---
  112. ## Examples
  113. ### Inbox Triage
  114. ```
  115. /email check
  116. # Returns:
  117. # - Importance scores (0-100) for each email
  118. # - Smart labels (urgent, actionable, informational, promotional)
  119. # - Contextual reply suggestions for top 5 emails
  120. ```
  121. ### Compose Marketing Email
  122. ```
  123. /email write
  124. # Interactive prompts:
  125. # - Email purpose (newsletter, promotion, announcement)
  126. # - Target audience
  127. # - Key message/offer
  128. # - CTA goal
  129. # - Tone/voice
  130. #
  131. # Generates email using appropriate framework (PAS, AIDA, etc.)
  132. ```
  133. ### Pre-Send Review
  134. ```
  135. /email review
  136. # Paste email content, receive:
  137. # - Overall score (0-100)
  138. # - Category scores: clarity, professionalism, CTA, tone, technical
  139. # - Specific improvement suggestions
  140. # - Subject line A/B test variants
  141. ```
  142. ### Deliverability Audit
  143. ```
  144. /email audit yourdomain.com
  145. # Checks:
  146. # - SPF/DKIM/DMARC DNS records
  147. # - Blacklist status (20+ databases)
  148. # - Google/Yahoo bulk sender compliance
  149. # - HTML rendering quality
  150. # - Spam score prediction
  151. ```
  152. ### Design Automation Sequence
  153. ```
  154. /email sequence welcome
  155. # Generates:
  156. # - 5-7 email sequence with timing recommendations
  157. # - Subject lines and preview text
  158. # - Full email copy for each message
  159. # - Branching logic based on engagement
  160. # - Success metrics and optimization tips
  161. ```
  162. ### Marketing Strategy
  163. ```
  164. /email plan saas
  165. # Delivers:
  166. # - 90-day roadmap with campaigns
  167. # - Segmentation strategy
  168. # - Content calendar
  169. # - KPI targets and benchmarks
  170. # - Platform/tool recommendations
  171. ```
  172. ---
  173. ## User Profile System
  174. On first run, `/email` generates an `email-profile.md` file in your project root with:
  175. - **Business type**: local business, SaaS, e-commerce, creator, agency, personal
  176. - **Primary email platform**: Gmail, Outlook, other
  177. - **Compliance regions**: US only, EU/GDPR, both
  178. - **Brand voice**: professional, friendly, casual, authoritative
  179. All sub-skills reference this profile to adapt recommendations. Delete `email-profile.md` to re-run onboarding.
  180. ---
  181. ## License
  182. MIT License - see [LICENSE](LICENSE) for details.
  183. ---
  184. ## Support
  185. For support, please use [GitHub Issues](https://github.com/AgriciDaniel/claude-email/issues) or [Discussions](https://github.com/AgriciDaniel/claude-email/discussions).
  186. ---
  187. ## Changelog
  188. See [CHANGELOG.md](CHANGELOG.md) for version history and updates.
  189. ---
  190. ## Related Skills
  191. - **[claude-seo](https://github.com/AgriciDaniel/claude-seo)**: SEO content optimization and strategy
  192. - **[claude-ads](https://github.com/AgriciDaniel/claude-ads)**: Paid advertising campaign management
  193. - **claude-skool**: Community and course management (coming soon)
  194. ---
  195. **Powered by Claude Code** | **[Agent Skills Open Standard](https://agentskills.io)**
  196. ---
  197. ## Author
  198. Built by [Agrici Daniel](https://agricidaniel.com/about) - AI Workflow Architect.
  199. - [Blog](https://agricidaniel.com/blog) - Deep dives on AI marketing automation
  200. - [AI Marketing Hub](https://www.skool.com/ai-marketing-hub) - Free community, 2,800+ members
  201. - [YouTube](https://www.youtube.com/@AgriciDaniel) - Tutorials and demos
  202. - [All open-source tools](https://github.com/AgriciDaniel)
install.ps1 · Bundled script · 129 lines · 1 finding marked
  1. # install.ps1 — Install claude-email skill ecosystem (Windows)
  2. # Usage:
  3. # iwr -useb https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.ps1 | iex
    • Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
    • Line 3 on GitHub
  4. # Or:
  5. # powershell -ExecutionPolicy Bypass -File install.ps1
  6. $ErrorActionPreference = "Stop"
  7. $RepoUrl = "https://github.com/AgriciDaniel/claude-email"
  8. $SkillsDir = Join-Path $env:USERPROFILE ".claude\skills"
  9. $AgentsDir = Join-Path $env:USERPROFILE ".claude\agents"
  10. function Main {
  11. Write-Host "Installing claude-email skill ecosystem..." -ForegroundColor Cyan
  12. Write-Host ""
  13. # Check prerequisites
  14. Check-Prerequisites
  15. # Create target directories
  16. New-Item -ItemType Directory -Force -Path $SkillsDir | Out-Null
  17. New-Item -ItemType Directory -Force -Path $AgentsDir | Out-Null
  18. # Clone repo to temp directory
  19. $TempDir = Join-Path $env:TEMP "claude-email-$(Get-Random)"
  20. try {
  21. Write-Host "Cloning repository..."
  22. git clone --depth 1 $RepoUrl $TempDir 2>&1 | Out-Null
  23. # Copy main orchestrator skill
  24. Write-Host "Installing main orchestrator skill..."
  25. $EmailSkillDir = Join-Path $SkillsDir "email"
  26. Copy-Item -Path (Join-Path $TempDir "email") -Destination $EmailSkillDir -Recurse -Force
  27. # Copy sub-skills
  28. Write-Host "Installing sub-skills..."
  29. $SubSkillsPath = Join-Path $TempDir "skills"
  30. if (Test-Path $SubSkillsPath) {
  31. Get-ChildItem -Path $SubSkillsPath -Directory -Filter "email-*" | ForEach-Object {
  32. $SkillName = $_.Name
  33. Copy-Item -Path $_.FullName -Destination (Join-Path $SkillsDir $SkillName) -Recurse -Force
  34. Write-Host " ✓ $SkillName" -ForegroundColor Green
  35. }
  36. }
  37. # Copy agents
  38. Write-Host "Installing agents..."
  39. $AgentsPath = Join-Path $TempDir "agents"
  40. if (Test-Path $AgentsPath) {
  41. Get-ChildItem -Path $AgentsPath -File -Filter "email-*.md" | ForEach-Object {
  42. $AgentName = $_.Name
  43. Copy-Item -Path $_.FullName -Destination (Join-Path $AgentsDir $AgentName) -Force
  44. Write-Host " ✓ $AgentName" -ForegroundColor Green
  45. }
  46. }
  47. # Copy scripts
  48. $ScriptsPath = Join-Path $TempDir "scripts"
  49. if (Test-Path $ScriptsPath) {
  50. Write-Host "Installing scripts..."
  51. $TargetScriptsDir = Join-Path $EmailSkillDir "scripts"
  52. Copy-Item -Path $ScriptsPath -Destination $TargetScriptsDir -Recurse -Force
  53. }
  54. # Copy hooks
  55. $HooksPath = Join-Path $TempDir "hooks"
  56. if (Test-Path $HooksPath) {
  57. Write-Host "Installing hooks..."
  58. $TargetHooksDir = Join-Path $EmailSkillDir "hooks"
  59. Copy-Item -Path $HooksPath -Destination $TargetHooksDir -Recurse -Force
  60. }
  61. # Install Python dependencies
  62. $RequirementsFile = Join-Path $TempDir "requirements.txt"
  63. if (Test-Path $RequirementsFile) {
  64. Write-Host "Installing Python dependencies..."
  65. try {
  66. if (Get-Command pip3 -ErrorAction SilentlyContinue) {
  67. pip3 install -q -r $RequirementsFile 2>$null
  68. } elseif (Get-Command pip -ErrorAction SilentlyContinue) {
  69. pip install -q -r $RequirementsFile 2>$null
  70. } else {
  71. Write-Host " ⚠️ pip not found — skipping Python dependencies" -ForegroundColor Yellow
  72. }
  73. } catch {
  74. Write-Host " ⚠️ pip install failed — you may need to run: pip install -r requirements.txt" -ForegroundColor Yellow
  75. }
  76. }
  77. Write-Host ""
  78. Write-Host "✓ Installation complete!" -ForegroundColor Green
  79. Write-Host ""
  80. Write-Host "Usage:"
  81. Write-Host " /email — Interactive email assistant menu"
  82. Write-Host " /email check — Validate email before sending"
  83. Write-Host " /email write — Compose professional emails"
  84. Write-Host " /email review — Review and improve email drafts"
  85. Write-Host " /email audit — Analyze email deliverability"
  86. Write-Host " /email sequence — Build multi-email campaigns"
  87. Write-Host " /email plan — Design email strategy"
  88. Write-Host ""
  89. Write-Host "Skills installed at: $SkillsDir\email*"
  90. Write-Host "Agents installed at: $AgentsDir\email-*.md"
  91. Write-Host ""
  92. }
  93. finally {
  94. # Cleanup temp directory
  95. if (Test-Path $TempDir) {
  96. Remove-Item -Path $TempDir -Recurse -Force -ErrorAction SilentlyContinue
  97. }
  98. }
  99. }
  100. function Check-Prerequisites {
  101. if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
  102. if (-not (Get-Command python3 -ErrorAction SilentlyContinue)) {
  103. Write-Host "Error: Python not found. Please install Python 3.7+." -ForegroundColor Red
  104. exit 1
  105. }
  106. }
  107. if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
  108. Write-Host "Error: git not found. Please install git." -ForegroundColor Red
  109. exit 1
  110. }
  111. }
  112. # Run main function
  113. Main
install.sh · Bundled script · 116 lines · 1 finding marked
  1. #!/usr/bin/env bash
  2. # install.sh — Install claude-email skill ecosystem
  3. # Usage: curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 3 on GitHub
  4. set -euo pipefail
  5. REPO_URL="https://github.com/AgriciDaniel/claude-email"
  6. SKILLS_DIR="${HOME}/.claude/skills"
  7. AGENTS_DIR="${HOME}/.claude/agents"
  8. main() {
  9. echo "Installing claude-email skill ecosystem..."
  10. echo ""
  11. # Check prerequisites
  12. check_prerequisites
  13. # Create target directories
  14. mkdir -p "$SKILLS_DIR"
  15. mkdir -p "$AGENTS_DIR"
  16. # Clone repo to temp directory
  17. TEMP_DIR=$(mktemp -d)
  18. trap 'rm -rf "$TEMP_DIR"' EXIT
  19. echo "Cloning repository..."
  20. git clone --depth 1 "$REPO_URL" "$TEMP_DIR" >/dev/null 2>&1
  21. # Copy main orchestrator skill
  22. echo "Installing main orchestrator skill..."
  23. cp -r "$TEMP_DIR/email" "$SKILLS_DIR/"
  24. # Copy sub-skills
  25. echo "Installing sub-skills..."
  26. for skill_dir in "$TEMP_DIR/skills"/email-*; do
  27. if [[ -d "$skill_dir" ]]; then
  28. skill_name=$(basename "$skill_dir")
  29. cp -r "$skill_dir" "$SKILLS_DIR/"
  30. echo " ✓ $skill_name"
  31. fi
  32. done
  33. # Copy agents
  34. echo "Installing agents..."
  35. if [[ -d "$TEMP_DIR/agents" ]]; then
  36. for agent_file in "$TEMP_DIR/agents"/email-*.md; do
  37. if [[ -f "$agent_file" ]]; then
  38. agent_name=$(basename "$agent_file")
  39. cp "$agent_file" "$AGENTS_DIR/"
  40. echo " ✓ $agent_name"
  41. fi
  42. done
  43. fi
  44. # Copy scripts (if exists)
  45. if [[ -d "$TEMP_DIR/scripts" ]]; then
  46. echo "Installing scripts..."
  47. cp -r "$TEMP_DIR/scripts" "$SKILLS_DIR/email/"
  48. chmod +x "$SKILLS_DIR/email/scripts"/*.py 2>/dev/null || true
  49. fi
  50. # Copy hooks and make executable
  51. if [[ -d "$TEMP_DIR/hooks" ]]; then
  52. echo "Installing hooks..."
  53. cp -r "$TEMP_DIR/hooks" "$SKILLS_DIR/email/"
  54. chmod +x "$SKILLS_DIR/email/hooks"/*.sh 2>/dev/null || true
  55. chmod +x "$SKILLS_DIR/email/hooks"/*.py 2>/dev/null || true
  56. fi
  57. # Install Python dependencies
  58. if [[ -f "$TEMP_DIR/requirements.txt" ]]; then
  59. echo "Installing Python dependencies..."
  60. if command -v pip3 >/dev/null 2>&1; then
  61. pip3 install -q -r "$TEMP_DIR/requirements.txt" 2>/dev/null || {
  62. echo " ⚠️ pip install failed — you may need to run: pip3 install -r requirements.txt"
  63. }
  64. elif command -v pip >/dev/null 2>&1; then
  65. pip install -q -r "$TEMP_DIR/requirements.txt" 2>/dev/null || {
  66. echo " ⚠️ pip install failed — you may need to run: pip install -r requirements.txt"
  67. }
  68. else
  69. echo " ⚠️ pip not found — skipping Python dependencies"
  70. fi
  71. fi
  72. echo ""
  73. echo "✓ Installation complete!"
  74. echo ""
  75. echo "Usage:"
  76. echo " /email — Interactive email assistant menu"
  77. echo " /email check — Validate email before sending"
  78. echo " /email write — Compose professional emails"
  79. echo " /email review — Review and improve email drafts"
  80. echo " /email audit — Analyze email deliverability"
  81. echo " /email sequence — Build multi-email campaigns"
  82. echo " /email plan — Design email strategy"
  83. echo ""
  84. echo "Skills installed at: $SKILLS_DIR/email*"
  85. echo "Agents installed at: $AGENTS_DIR/email-*.md"
  86. echo ""
  87. }
  88. check_prerequisites() {
  89. if ! command -v python3 >/dev/null 2>&1; then
  90. echo "Error: python3 not found. Please install Python 3.7+."
  91. exit 1
  92. fi
  93. if ! command -v git >/dev/null 2>&1; then
  94. echo "Error: git not found. Please install git."
  95. exit 1
  96. fi
  97. }
  98. # Run main function (prevents partial execution on curl pipe)
  99. main "$@"

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.