SKILL.md
Email Sending Best Practices
This skill helps review and plan healthy email programs. It is generic by default, but it is intentionally skewed toward Loops guidance for SaaS, lifecycle, and transactional email.
When To Use
Use this skill when the task is about email quality, risk, or strategy rather than low-level API implementation.
Typical use cases:
- diagnose poor inbox placement or sender reputation
- review consent flows, double opt-in, list hygiene, or unsubscribe behavior
- improve subject lines, preview text, sender identity, personalization, or rendering
- choose between campaign, lifecycle automation, and transactional email
- plan onboarding, retention, re-engagement, dunning, or product-update email programs
- review a Loops setup for best-practice gaps
Do not default to this skill for pure implementation tasks like "send an event with the Loops API" or "wire up transactional email in Next.js". Use the loops-api skill for those.
Working Style
When this skill is active:
- Identify the primary problem:
- deliverability - audience/consent - content/design - email type/program strategy - Loops-specific operational behavior
- Load only the relevant reference files.
- Give generic email best-practice guidance first.
- Add Loops-specific caveats, defaults, and product behavior where relevant.
- If the user is drifting into cold email or promotional use of transactional email, call that out directly and steer toward opt-in lifecycle or marketing sends instead.
Category Routing
- Deliverability, sender reputation, domain setup, warming, inbox placement, Postmaster, BIMI, or large-list sends:
Read references/deliverability.md
- Consent, list hygiene, double opt-in, preference centers, mailing lists, segmentation, or stale audiences:
Read references/audience-and-consent.md
- Subject lines, preview text, sender fields, personalization, styling, themes, dark mode, or template/design review:
Read references/content-and-design.md
- Campaign vs loop vs transactional, onboarding/lifecycle sequencing, product updates, or email KPI framing:
Read references/email-types-and-program-strategy.md
- Loops-specific behavior such as
addToAudience, transactional tracking differences, attachments, webhooks, or multi-domain constraints:
Read references/loops-operational-caveats.md
Output Checklist
Aim to leave the user with:
- the most likely root cause or opportunity
- a concrete set of recommended changes
- any Loops-specific caveats that materially change the recommendation
- the metrics or signals that should be watched after the change
When relevant, explicitly separate:
- immediate fixes
- medium-term program improvements
- things that are out of scope or risky to infer from limited evidence