Kit Broadcast Skill

Create and schedule email broadcasts for new blog posts.

Workflow

1. Read the blog post from src/content/blog/{slug}.md
2. Extract key information:
   • Title from frontmatter
   • 3-4 key points from the content
   • Build post URL: https://claudecodeformarketers.com/blog/{slug}
3. Generate email copy following the template in references/email-template.md
4. Present the email to user for review (subject + HTML content)
5. Ask for schedule time in ISO8601 format (e.g., 2026-01-20T10:00:00-06:00)
6. Create broadcast using scripts/kit_broadcast.py

Script usage

# Load API key from .env in project root
source /Users/keanan/code/claude-code-for-marketers/.env && export KIT_API_KEY

# Dry run (test without sending)
python scripts/kit_broadcast.py \
  --subject "[CC4M] Post Title" \
  --content "<p>HTML content here</p>" \
  --send-at "2026-01-20T10:00:00-06:00" \
  --dry-run

# Create scheduled broadcast
python scripts/kit_broadcast.py \
  --subject "[CC4M] Post Title" \
  --content "<p>HTML content here</p>" \
  --send-at "2026-01-20T10:00:00-06:00"

Timezone

User is in US Central time. When they say "10am tomorrow", convert to ISO8601 with -06:00 offset (CST) or -05:00 (CDT during daylight saving).

Subscriber targeting

Broadcasts use the "CC4M broadcast audience" segment (ID: 544062), which is configured in the Kit UI to:

• Include: Subscribers with the "CC4M" tag
• Exclude: Subscribers currently in the "Welcome to CC4M" onboarding sequence

This ensures new subscribers complete their onboarding emails before receiving broadcast announcements. The segment ID is hardcoded in the script.

Why a segment? The Kit API v4 only supports tag and segment filter types, and only one filter group type (all, any, or none) per API call. Sequence exclusion requires a pre-built segment that combines both filters in the Kit UI.

After scheduling

Report back:

• Broadcast ID from API response
• Scheduled send time
• Audience: CC4M tag subscribers
• Suggest user verify in Kit dashboard at https://app.kit.com/broadcasts