Email Best Practices

From the author

AutoGineer summary

Install

Documentation by Resend

[User] → [Email Form] → [Validation] → [Double Opt-In]
                                              ↓
                                    [Consent Recorded]
                                              ↓
[Suppression Check] ←──────────────[Ready to Send]
        ↓
[Idempotent Send + Retry] ──────→ [Email API]
                                       ↓
                              [Webhook Events]
                                       ↓
              ┌────────┬────────┬─────────────┐
              ↓        ↓        ↓             ↓
         Delivered  Bounced  Complained  Opened/Clicked
                       ↓        ↓
              [Suppression List Updated]
                       ↓
              [List Hygiene Jobs]

Files

// Suppression list schema
interface SuppressionEntry {
  email: string;
  reason: 'hard_bounce' | 'complaint' | 'unsubscribe' | 'soft_bounce' | 'manual';
  created_at: Date;
  source_email_id?: string; // Which email triggered this
}

// Check before every send
async function canSendTo(email: string): Promise<boolean> {
  const suppressed = await db.suppressions.findOne({ email });
  return !suppressed;
}

// Add to suppression list
async function suppressEmail(email: string, reason: string, sourceId?: string) {
  await db.suppressions.upsert({
    email: email.toLowerCase(),
    reason,
    created_at: new Date(),
    source_email_id: sourceId,
  });
}

async function sendEmail(to: string, emailData: EmailData) {
  if (!await canSendTo(to)) {
    console.log(`Skipping suppressed email: ${to}`);
    return { skipped: true, reason: 'suppressed' };
  }

  return await resend.emails.send({ to, ...emailData });
}

async function runReengagement() {
  const inactive = await getInactiveSubscribers(90); // 90 days

  for (const subscriber of inactive) {
    if (!subscriber.reengagement_sent) {
      await sendReengagementEmail(subscriber);
      await markReengagementSent(subscriber.email);
    } else if (daysSince(subscriber.reengagement_sent) > 30) {
      await removeFromMarketingLists(subscriber.email);
    }
  }
}

// Daily cleanup job
async function cleanupOldData() {
  const now = new Date();

  // Delete old email logs (keep 90 days)
  await db.emailLogs.deleteMany({
    created_at: { $lt: subDays(now, 90) }
  });

  // Delete old email content (keep 30 days)
  await db.emailContent.deleteMany({
    created_at: { $lt: subDays(now, 30) }
  });

  // Never delete: suppressions, consent records
}

Requirements and compatibility

Security

Related skills

• 

  Copywriting

  Corey Haines· Community

  Expert conversion copywriting for marketing pages that avoids AI-generated patterns and focuses on clarity, specificity, and customer-centric messaging.

  Business and productivityClaude CodeClaude appsOpenAI Codex+14 more

  MITGitHub stars of the source repository59k
• 

  Popups

  Corey Haines· Community

  Expert guidelines for designing and optimizing conversion-focused popups, modals, and banners that respect user experience.

  Business and productivityClaude CodeClaude appsOpenAI Codex+14 more

  MITGitHub stars of the source repository59k
• 

  Content Strategy

  Corey Haines· Community

  A strategic framework for planning, prioritizing, and managing content that drives traffic, builds authority, and generates leads.

  Business and productivityClaude CodeClaude appsOpenAI Codex+14 more

  MITGitHub stars of the source repository59k
• 

  Ad Creative

  Corey Haines· Community

  Generates and iterates on paid advertising creative, including headlines, ad copy, and visual concepts based on performance data and brand context.

  Business and productivityClaude CodeClaude appsOpenAI Codex+14 more

  MITGitHub stars of the source repository59k
• 

  Attribution

  Corey Haines· Community

  Analyze marketing performance by reconciling attribution models, tracking journeys, and identifying the true drivers of revenue.

  Business and productivityClaude CodeClaude appsOpenAI Codex+14 more

  MITGitHub stars of the source repository59k
• 

  Reverse Engineer Marketing

  Corey Haines· Community

  A growth analysis framework that reverse engineers competitor marketing strategies using public data to identify actionable growth plays.

  Business and productivityClaude CodeClaude appsOpenAI Codex+14 more

  MITLow riskHas scriptsGitHub stars of the source repository59k

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download email-best-practices.zip