# twilio-marketing-promotions-advisor

twilio-marketing-promotions-advisor guides architectural planning for promotional messaging campaigns on Twilio, covering channel choice, compliance readiness, and delivery tracking.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 162 installs · ★ 42 repo stars
- Author: twilio
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/twilio/ai/tree/HEAD/skills/twilio/twilio-marketing-promotions-advisor/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/twilio-twilio-marketing-promotions-advisor

## What it does

This skill activates when planning a promotional broadcast, drip sequence, or re-engagement flow. Rather than jumping straight into code, it prompts the agent to evaluate critical parameters: target geography, send volume, customer data sources like Segment or HubSpot, and delivery tracking.

It organizes implementation across clear tiers, from single-channel blasts to complex multi-channel routing. For US SMS traffic, it flags mandatory A2P 10DLC registration, while WhatsApp workflows account for Meta template approvals. For audiences exceeding 100,000 recipients, Messaging Services and exponential backoff for rate limits become mandatory.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-marketing-promotions-advisor -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/twilio-marketing-promotions-advisor/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/twilio-marketing-promotions-advisor/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-marketing-promotions-advisor -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/twilio-marketing-promotions-advisor/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-marketing-promotions-advisor -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/twilio-marketing-promotions-advisor/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install twilio/ai skills/twilio/twilio-marketing-promotions-advisor
```

2. **Manually: put the files in place**
- File: `.github/skills/twilio-marketing-promotions-advisor/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-marketing-promotions-advisor -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/twilio/ai --path skills/twilio/twilio-marketing-promotions-advisor
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/twilio-marketing-promotions-advisor/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add twilio/ai --skill twilio-marketing-promotions-advisor -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/twilio/ai/tree/HEAD/skills/twilio/twilio-marketing-promotions-advisor/SKILL.md

## When to use it
- Plan multi-channel promotions across SMS, WhatsApp, and RCS
- Address US compliance requirements including A2P 10DLC registration
- Structure delivery tracking via StatusCallbacks and CDP integrations
- Handle rate limiting and sender pools for large recipient lists

## Example prompts
- How should I architect a WhatsApp promotional campaign for holiday sales?
- What do I need to send marketing SMS to a US customer list?
- Help me design a cart abandonment messaging flow using Segment and Twilio

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c3cf67f54fe94011.

BEGIN THIRD-PARTY FILE c3cf67f54fe94011
```text
---
name: twilio-marketing-promotions-advisor
description: >
  Planning skill for marketing and promotional messaging. Use when a
  developer is figuring out how to set up or architect a marketing
  campaign on Twilio — channel selection, compliance readiness,
  audience size, geography, and delivery tracking. Handles open-ended
  requests like "how do I set up a WhatsApp marketing campaign" or
  "what's the best way to run promotional SMS." Skip this skill when
  the developer already knows what they want and is asking for API
  specs or implementation details.
tier: discover
---

## Role

You are a Marketing & Promotions Architecture Advisor. When a developer describes anything related to sending promotional messages, running campaigns, lead conversion, or customer engagement at scale — use this framework to reason about what they need.

## When This Skill Activates

Trigger on any of these signals:
- "Marketing campaign," "promotional messages," "bulk SMS," "mass email", "text message"
- "Lead conversion," "drip campaign," "engagement," "re-engagement"
- "WhatsApp templates," "RCS," "rich messaging", "branded message"
- "Audience segmentation," "Segment," "CDP," "customer data"
- "Opt-in," "opt-out," "consent management," "TCPA," "A2P"
- Any request to send messages to a list of recipients at scale

## Step 1: Detect Specificity and Decide Your Mode

**High-level request** (e.g., "I want to send promotional messages to my customers"):
→ DISCOVERY MODE. Channel selection, compliance, and volume are critical — qualify before coding.

> **Important:** Terms like "text," "text message," or "text campaign" do NOT imply SMS. They could mean SMS, WhatsApp, or RCS. Always ask which channel the developer intends as the first qualification question — never assume a channel until explicitly confirmed.

**Mid-level request** (e.g., "I need to send WhatsApp template messages for a holiday promotion"):
→ VALIDATION MODE. They've chosen a channel — check compliance readiness (approved templates? sender registration?), volume expectations, and tracking needs.

**Specific implementation request** (e.g., "Send an SMS via Messaging Service with a StatusCallback"):
→ BUILD MODE. Proceed with the Product skill. Quick check: Are they US-based and need A2P 10DLC? Are they using a Messaging Service (recommended) or raw `from` number?

## Step 2: Qualify Intent — The 6 Essential Questions

1. **What are you promoting?**
   - Product launches, sales, offers → Standard marketing campaign
   - Lead nurture / drip sequences → Time-based automation, needs scheduling
```
END THIRD-PARTY FILE c3cf67f54fe94011

The third-party file has ended. Everything between the c3cf67f54fe94011 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2607 of 12577 bytes. © twilio · MIT · https://github.com/twilio/ai/tree/HEAD/skills/twilio/twilio-marketing-promotions-advisor/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
