SMS marketing
A text interrupts, so it has to be worth the interruption. This repo requires provable signed written consent for US marketing texts and revocation honored however the person phrases it; registration and throughput depend on the selected sender type, with Trust Score applying to 10DLC. This skill adapts the coreyhaines31/marketingskills sms skill (v1.1.0, MIT) and corrects it against the FCC's TCPA rules (47 CFR 64.1200 and order FCC 24-24), the CTIA Messaging Principles and Short Code Monitoring Handbook, Twilio's A2P 10DLC, pricing and throughput pages, and Meta's WhatsApp docs as the source cites them. The source reads .agents/product-marketing.md; here the shared file is .agents/product-context.md (anti-slop-copy CONTEXT.md). Sending through OneSignal (senders, keywords, Journeys, quiet-hours nodes) is onesignal EMAIL-AND-SMS.md; email delivery is email-practices SKILL.md and sequences/copy are email-marketing SKILL.md; phone-number capture popups are cro POPUPS.md; the phone field itself is web-accessibility PHONE-NUMBERS.md.
Apply only the routes and checks for the selected job. Read a linked skill's named file from its installed folder when available, or from the linked source. Report an unavailable required reference instead of inventing it. [skill-authoring, DISTRIBUTION.md#composing-skills]
| The job | Read |
|---|---|
| The intake questions, when SMS beats email, cost per send, copy structure, links, segments and encoding, voice, the source's benchmarks, A/B tests, the plan to return, common mistakes | CHANNEL-AND-COPY.md |
| Welcome, abandoned cart, browse, post-purchase, win-back, promotional, transactional, re-engagement, replenishment and VIP templates with timing, and segmentation rules | SEQUENCES.md |
| TCPA versus CTIA versus platform rules, written consent, the opt-in disclosure, FCC revocation and the one confirmation text, STOP/HELP replies, the footer, quiet hours, Do-Not-Call, SHAFT, other countries, no cold texting, the audit checklist | COMPLIANCE.md |
| A2P 10DLC brand and campaign registration, fees, Trust Score throughput and T-Mobile caps, unregistered traffic, per-message price, number types, rejections, approval time | REGISTRATION.md |
| WhatsApp: when it beats SMS, the 24-hour window, template categories, opt-in, quality rating and messaging limits, formats, phone numbers, per-message pricing, click-to-WhatsApp ads, playbooks | WHATSAPP.md |
The rules
- Send marketing texts only with prior express written consent that names the seller and the number and says consent is not a condition of purchase (47 CFR 64.1200(a)(2), (f)(9)); a number given at checkout is not consent (COMPLIANCE.md).
- Treat any reasonable wording as a revocation, not only the seven per se keywords, honor it at once and never later than ten business days, and send one confirmation with no marketing (64.1200(a)(10), (a)(12); a 2026 FCC order lets senders designate an exclusive opt-out method once it takes effect: COMPLIANCE.md).
- Put the brand name first and an opt-out instruction in every message (the repo's OneSignal rule; the source's "quarterly" has no official source).
- Register the brand and every campaign before the first US 10DLC send, keep sample messages identical to live sends, and plan volume from the Trust Score's MPS and T-Mobile's daily brand cap (Twilio; REGISTRATION.md).
- Keep promotional texts between 8 a.m. and 9 p.m. recipient-local (64.1200(c)(1)), or the stricter state window, and honor Do-Not-Call for marketing texts (COMPLIANCE.md).
- Send by text only what can't wait 24 hours; everything else goes by email [coreyhaines31/marketingskills, sms].
- Count the actual encoded segments before sending, including the final footer; the corrected GSM-7/UCS-2 rules and the old accent claim are in CHANNEL-AND-COPY.md. [https://www.twilio.com/docs/glossary/what-sms-character-limit]
- One link per text on a branded or platform domain, never a public shortener (OneSignal; CHANNEL-AND-COPY.md).
- No discount in the first cart text, double opt-in for US cart programs, and no urgency, hold or expiry claim that isn't true (SEQUENCES.md).
- On WhatsApp, use an approved marketing template outside the 24-hour window, and never plan marketing templates to US numbers (Meta, as cited by the source; WHATSAPP.md).
- Never text people cold, and label every benchmark as the source's figure, not a target (COMPLIANCE.md).
Prove it
- A plan opens with the compliance check (sender type and its applicable registration, opt-in mechanism) and flags blockers before any strategy.
- Every flow names its trigger, delays, copy with character and segment counts, one CTA, and its exit conditions.
- Test replies of "STOP", "opt out" and "please stop texting me" each end marketing texts with one confirmation.
- The send schedule fits the selected sender's throughput and quiet-hours window, including the applicable T-Mobile daily brand cap for 10DLC.
- No figure in the plan is presented as a platform rule unless an official page in these files says it, and every file's own Prove it checks pass for the parts you touched.