version: "1.0.0" name: email-campaigner description: Create and run email campaigns using the email providers that the workflow actually needs. Use for newsletters, nurture sequences, launch campaigns, promotional sends, and campaign link tracking.

Email Campaigner

Focused email execution skill for campaign planning and send-ready email assets.

Scope

This skill owns one job: building email campaigns.

It does not generate social content, publishing plans, or general content strategy.

Task

Providers

This skill is connected only to providers that are directly relevant to email execution:

• resend
• mailchimp
• sendgrid
• kit
• dub

Usage

cd skills/email-campaigner
uv sync
# Copy and fill in the brief:
cp input/brief.example.json input/brief.json
# Then run:
uv run python scripts/campaign.py

With explicit provider or custom paths:

uv run python scripts/campaign.py --provider resend
uv run python scripts/campaign.py --input ./input --output ./output
uv run python scripts/campaign.py --dry-run

Input

input/brief.json — see input/brief.example.json for the full field reference.

Required fields: subject, from_name, from_email, plus one of to / list_id / audience_id / segment_id, plus body_html or body_text.

Output

output/send-TIMESTAMP.json — provider response, recipient count, and any Dub short-link mappings.

Provider selection

If provider is not set in the brief and --provider is not passed, the first provider with a matching API key in the environment is used (priority: resend → mailchimp → sendgrid → kit).

Environment variables

Kit limitation

Kit's v3 API creates broadcast drafts but has no programmatic send endpoint. After running, open the Kit dashboard to publish the broadcast. The broadcast ID is printed to stdout and included in the output report.

Related Skills

• brand-strategist - positioning and message inputs
• post-scheduler - publishing remains separate
• brand-manager - brand asset management