$npx -y skills add AgriciDaniel/claude-email --skill email-reviewPre-send email quality review and scoring across 5 dimensions (subject line, copy quality, technical/HTML, deliverability, compliance). Analyzes subject lines, body copy, HTML structure, spam triggers, and CAN-SPAM compliance. Scores 0-100 with detailed recommendations for improv
| 1 | # Email Review Sub-Skill |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | Reviews email content before sending and provides a comprehensive quality score (0-100) across 5 weighted dimensions. Identifies critical issues, suggests improvements, and provides a rewritten version for low-scoring emails. |
| 6 | |
| 7 | ## When to Activate |
| 8 | |
| 9 | - User asks to "review this email" |
| 10 | - User provides email content (subject + body) for feedback |
| 11 | - User requests email quality check or score |
| 12 | - User wants to validate email before sending |
| 13 | - User provides Gmail draft ID for review |
| 14 | - User asks about email deliverability or spam risk |
| 15 | |
| 16 | ## Input Formats |
| 17 | |
| 18 | Accept email content in any of these formats: |
| 19 | |
| 20 | 1. **Pasted text** - Subject line + body in conversation |
| 21 | 2. **File path** - Path to HTML email file |
| 22 | 3. **Gmail draft ID** - Fetch via `gmail_get_draft` MCP tool |
| 23 | 4. **Raw HTML** - HTML email source code |
| 24 | |
| 25 | ## Scoring Framework |
| 26 | |
| 27 | ### Overall Score Calculation |
| 28 | |
| 29 | Total score = weighted sum of 5 categories: |
| 30 | |
| 31 | | Category | Weight | Focus | |
| 32 | |----------|--------|-------| |
| 33 | | Subject Line | 25% | Length, power words, spam triggers, personalization | |
| 34 | | Copy Quality | 25% | Word count, CTA clarity, framework structure, readability | |
| 35 | | Technical/HTML | 20% | Size, responsiveness, dark mode, alt text, preheader | |
| 36 | | Deliverability | 15% | Spam signals, link count, sender reputation factors | |
| 37 | | Compliance | 15% | CAN-SPAM, unsubscribe, physical address, RFC 8058 | |
| 38 | |
| 39 | --- |
| 40 | |
| 41 | ## 1. Subject Line Scoring (25% weight) |
| 42 | |
| 43 | **Base Score: 0-100, then weighted at 25%** |
| 44 | |
| 45 | ### Length Check (0-25 points) |
| 46 | - **Optimal**: 6-10 words OR 30-50 characters = 25 points |
| 47 | - **Acceptable**: 5 or 11 words = 20 points |
| 48 | - **Marginal**: 4 or 12 words = 10 points |
| 49 | - **Poor**: <4 or >12 words = 0 points |
| 50 | |
| 51 | ### Spam Trigger Detection (-5 points each) |
| 52 | Penalize for each occurrence: |
| 53 | - ALL CAPS words |
| 54 | - Multiple exclamation marks (!!!) |
| 55 | - Phrases: "FREE", "Act Now", "Limited Time", "Guaranteed", "Winner", "Click Here", "Buy Now", "Order Now" |
| 56 | - Excessive punctuation ($$$, ???) |
| 57 | |
| 58 | ### Power Words (+5 points each, max +15) |
| 59 | Bonus for strategic use of: |
| 60 | - "New", "Exclusive", "Proven", "Secret", "Discover" |
| 61 | - "Ultimate", "Essential", "Complete", "Breakthrough" |
| 62 | - Industry-specific power words |
| 63 | |
| 64 | ### Personalization (+10 points) |
| 65 | - Contains merge tags like `{{first_name}}` or `{{company}}` |
| 66 | - Behavioral personalization indicators |
| 67 | |
| 68 | ### Emoji Usage (+5 or -5) |
| 69 | - **1 emoji** = +5 points (increases open rates) |
| 70 | - **2+ emojis** = -5 points (reduces professionalism) |
| 71 | - **No emoji** = 0 points (neutral) |
| 72 | |
| 73 | --- |
| 74 | |
| 75 | ## 2. Copy Quality Scoring (25% weight) |
| 76 | |
| 77 | **Base Score: 0-100, then weighted at 25%** |
| 78 | |
| 79 | ### Word Count (0-20 points) |
| 80 | - **150-300 words** = 20 points (optimal) |
| 81 | - **100-149 or 301-400** = 15 points |
| 82 | - **50-99 or 401-500** = 10 points |
| 83 | - **<50 or >500** = 0 points |
| 84 | |
| 85 | ### CTA Count (0-25 points) |
| 86 | - **1 primary CTA** = 25 points (best conversion) |
| 87 | - **2 CTAs** = 15 points (acceptable) |
| 88 | - **3+ CTAs** = 5 points (diluted focus) |
| 89 | - **0 CTAs** = 0 points (no action path) |
| 90 | |
| 91 | ### CTA Clarity (0-15 points) |
| 92 | Score based on: |
| 93 | - **15 points**: Action verb + benefit ("Get My Free Guide", "Start Your Trial") |
| 94 | - **10 points**: Generic action ("Learn More", "Download") |
| 95 | - **5 points**: Vague ("Submit", "Click Here") |
| 96 | - **0 points**: No CTA or unclear |
| 97 | |
| 98 | ### Framework Structure (0-15 points) |
| 99 | Check if email follows proven framework: |
| 100 | - **PAS (Problem-Agitate-Solution)**: 15 points |
| 101 | - **AIDA (Attention-Interest-Desire-Action)**: 15 points |
| 102 | - **BAB (Before-After-Bridge)**: 15 points |
| 103 | - **FAB (Features-Advantages-Benefits)**: 15 points |
| 104 | - **4Ps (Picture-Promise-Proof-Push)**: 15 points |
| 105 | - **No clear structure**: 0 points |
| 106 | |
| 107 | ### Readability (0-15 points) |
| 108 | - Short paragraphs (2-3 lines max): +5 |
| 109 | - Bullet points or numbered lists: +5 |
| 110 | - Scannable with subheadings: +5 |
| 111 | - No walls of text: +5 |
| 112 | - Deduct -5 for each readability issue |
| 113 | |
| 114 | ### Personalization Beyond Name (0-10 points) |
| 115 | - Behavioral triggers (past purchase, browsing): +5 |
| 116 | - Location/timezone awareness: +3 |
| 117 | - Industry/role customization: +2 |
| 118 | |
| 119 | --- |
| 120 | |
| 121 | ## 3. Technical/HTML Scoring (20% weight) |
| 122 | |
| 123 | **Base Score: 100, deduct points for violations** |
| 124 | |
| 125 | ### Total Size (-20 if fail) |
| 126 | - **Must be under 102 KB** (Gmail clips emails over this) |
| 127 | - Check HTML + embedded images (if data URIs) |
| 128 | |
| 129 | ### Text-to-Image Ratio (-15 if fail) |
| 130 | - **Minimum 60% text / 40% images** |
| 131 | - Image-heavy emails trigger spam filters |
| 132 | |
| 133 | ### Responsive Design (-10 if fail) |
| 134 | Check for: |
| 135 | - Viewport meta tag: `<meta name="viewport" content="width=device-width">` |
| 136 | - Media queries for mobile breakpoints |
| 137 | - Fluid tables or container w |