SKILL·E64BE5

lifecycle-messaging

avelikiy
Updated 12 days ago
49
11
49
View on GitHub
Metaaidesign

About

This skill provides a framework for implementing transactional and lifecycle emails/SMS with built-in deliverability and compliance. It codifies provider selection, domain authentication, consent handling, and suppression list management. Developers should apply it when designing any feature that sends external messages to ensure best practices are integrated from the start.

Quick Install

Claude Code

Recommended
Primary
npx skills add avelikiy/great_cto -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/avelikiy/great_cto
Git CloneAlternative
git clone https://github.com/avelikiy/great_cto.git ~/.claude/skills/lifecycle-messaging

Copy and paste this command in Claude Code to install this skill

Documentation

Lifecycle messaging — deliverable, consented, compliant

Messages that don't arrive (poor deliverability) or that arrive without consent (TCPA/ CAN-SPAM violations) are both fatal for an SMB product. This skill makes both correct by construction. Design the consent + deliverability posture before the first send.

1. Transactional vs marketing — split them

Decide per message which bucket it is; they have different rules and should use different sending identities (often different subdomains / providers):

TransactionalMarketing / lifecycle
Examplesreceipt, booking confirm/reminder, password resetwin-back, promo, newsletter, nurture step
Consentimplied by the transactionexplicit opt-in required
Unsubscribenot required (but honor STOP)required, one-click, honored fast
Sending domaintxn. subdomainmail./news. subdomain

Never send marketing content on the transactional channel "because it delivers better" — that's how the transactional domain gets burned.

2. Provider selection (pick one, justify it)

  • Email — Postmark (best transactional deliverability, strict on marketing), Resend (DX-first, good default), SendGrid (scale). Default: Resend for transactional, add a marketing-grade ESP only when lifecycle volume justifies it.
  • SMS — Twilio (messaging service + sender pool), or Telnyx. Use a Messaging Service, not a single number, for scale + failover. A2P 10DLC registration is required for US application-to-person SMS — register the brand/campaign before sending.

3. Domain authentication (non-negotiable for email)

  • SPF — sender IP authorized in DNS.
  • DKIM — provider signing key published; messages signed.
  • DMARC — start p=none with rua reporting, ramp to p=quarantinep=reject once aligned. Without DMARC alignment, lifecycle mail lands in spam.
  • Warm up a new sending domain gradually; never blast from a cold domain.

4. Consent + compliance (US-first)

  • CAN-SPAM (email) — valid physical postal address, accurate From/Subject, working one-click unsubscribe honored within 10 days.
  • TCPA (SMS/voice) — prior express written consent for marketing SMS; honor STOP/UNSTOP/ HELP keywords automatically; respect quiet hours (no marketing 9pm–8am recipient local time). Keep proof of consent (timestamp, source).
  • CASL (if CA recipients) — express opt-in + identification + unsubscribe.
  • Double opt-in for marketing lists where feasible — protects deliverability and proves consent.

5. Suppression discipline (the deliverability lifeline)

Maintain a single suppression list the sender checks before every send:

  • hard bounces → suppress permanently
  • spam complaints (FBL) → suppress + investigate
  • unsubscribes / STOP → suppress for that channel immediately
  • never re-import a suppressed address from a migration without re-consent

A send that ignores suppression is the fastest path to a blocklist.

6. Reliability patterns

  • Idempotent sends keyed on the domain event (a reminder for booking X sends once, even on retry) — coordinate the key with integrations-engineer.
  • Status-callback / webhook reconciliation: record delivered/bounced/failed; surface failures, don't swallow them.
  • Rate-limit + queue lifecycle sends; never loop-send.
  • Quiet-hours + timezone are computed from the recipient's locale, not the server's.

Output

When applied, contribute a Messaging section to the integration contract (docs/integrations/INTEGRATE-{slug}.md):

## Messaging
- channels: email <provider> / sms <provider>
- identities: txn = <subdomain>, marketing = <subdomain/ESP>
- domain auth: SPF/DKIM/DMARC plan = <state>
- consent: <implied/explicit per message type>; STOP/HELP = handled
- quiet hours: <recipient-local window>; 10DLC: <registered?>
- suppression: <store> checked pre-send
- idempotency key: <derivation>

GitHub Repository

avelikiy/great_cto
Path: skills/lifecycle-messaging
0
agentic-codingclaude-code-pluginclaude-code-skillsclaude-code-subagentscode-reviewcto
FAQ

Frequently asked questions

What is the lifecycle-messaging skill?

lifecycle-messaging is a Claude Skill by avelikiy. Skills package instructions and resources that Claude loads on demand, so Claude can perform lifecycle-messaging-related tasks without extra prompting.

How do I install lifecycle-messaging?

Use the install commands on this page: add lifecycle-messaging to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does lifecycle-messaging belong to?

lifecycle-messaging is in the Meta category, tagged ai and design.

Is lifecycle-messaging free to use?

Yes. lifecycle-messaging is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.

Related Skills

content-collections
Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill
polymarket
Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill
creating-opencode-plugins
Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill
sglang
Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill