kkoppenhaver Kit Broadcast Skill
Create and schedule email broadcasts for new blog posts.
Workflow
- Read the blog post from
src/content/blog/{slug}.md - Extract key information:
- Title from frontmatter
- 3-4 key points from the content
- Build post URL:
https://claudecodeformarketers.com/blog/{slug}
- Generate email copy following the template in
references/email-template.md - Present the email to user for review (subject + HTML content)
- Ask for schedule time in ISO8601 format (e.g.,
2026-01-20T10:00:00-06:00) - 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