media-plan
Create a paid media plan. Use when: building media buy schedules, cross-channel budget allocation, or creative rotation calendars.
What this skill does
# /digital-marketing-pro:media-plan
## Purpose
Generate a holistic paid media plan that coordinates budget, channels, audiences, creative, and timing across all advertising platforms. Balances reach and efficiency objectives with practical execution constraints to produce a ready-to-implement plan with clear pacing targets and contingency protocols.
## Input Required
The user must provide (or will be prompted for):
- **Campaign dates**: Start date, end date, and any blackout periods or mandatory flight windows
- **Total paid media budget**: Aggregate budget for the campaign period with any channel-specific floors or caps
- **Channels available**: Platforms in consideration — Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, programmatic display, connected TV, native, audio, out-of-home, etc.
- **Campaign objectives**: Primary and secondary objectives — awareness (reach/impressions), consideration (traffic/engagement), conversion (leads/sales/ROAS)
- **Target audiences with segments**: Audience definitions including demographics, interests, behaviors, custom audiences, lookalikes, and retargeting pools
- **Creative assets available**: Existing ad formats and sizes, video lengths, static variants, and any creative production timelines for new assets
- **Geographic targeting**: Markets, regions, DMAs, or countries to target with any geo-specific budget weighting
- **Competitive spending intelligence**: Known or estimated competitor ad spend, share of voice benchmarks, and auction pressure indicators
- **Historical performance by channel**: Past campaign data — CPC, CPM, CPA, ROAS, conversion rates — by channel and audience segment
- **Seasonality factors**: Demand fluctuations, industry events, holidays, promotional periods, or competitive surges that affect costs or performance
## Process
1. **Load brand context**: Read `~/.claude-marketing/brands/_active-brand.json` for the active slug, then load `~/.claude-marketing/brands/{slug}/profile.json`. Apply brand voice, compliance rules for target markets (`skills/context-engine/compliance-rules.md`), and industry context. **Also check for guidelines** at `~/.claude-marketing/brands/{slug}/guidelines/_manifest.json` — if present, load restrictions and relevant category files. Check for custom templates at `~/.claude-marketing/brands/{slug}/templates/`. Check for agency SOPs at `~/.claude-marketing/sops/`. If no brand exists, ask: "Set up a brand first (/digital-marketing-pro:brand-setup)?" — or proceed with defaults.
2. **Assess channel-objective fit**: Evaluate each available channel against campaign objectives using reach capability, targeting precision, cost benchmarks, creative format support, and measurement reliability
3. **Allocate budget across channels**: Distribute budget using efficiency-weighted allocation — factor in historical performance, diminishing returns curves, minimum effective spend thresholds, and strategic importance per channel
4. **Design flight schedule**: Structure campaign timing as continuous, pulsing, or flighting based on objectives, seasonality, and budget — define weekly spend levels and heavy-up periods
5. **Build audience targeting matrix**: Map each audience segment to its optimal channel(s) with targeting parameters, expected reach, estimated frequency, and overlap management between platforms
6. **Plan creative rotation**: Schedule creative variants across channels with rotation frequency, fatigue thresholds (impressions or frequency caps), A/B test windows, and refresh dates for new assets
7. **Define measurement framework**: Establish KPIs per channel, tracking requirements (pixels, UTMs, offline conversion imports), attribution model, and reporting cadence
8. **Set contingency holdback**: Reserve 10-15% of budget as contingency for opportunistic scaling, underperformance reallocation, or emerging platform opportunities — define trigger criteria for deployment
9. **Create platform setup checklists**: Build channel-specific setup checklists covering account structure, campaign naming conventions, tracking implementation, audience uploads, and creative specs
10. **Model reach and frequency estimates**: Project total reach, average frequency, and effective frequency per channel and in aggregate — flag oversaturation or underspend risks
11. **Compile unified media plan calendar**: Assemble all components into a single calendar view showing budget pacing, creative rotation, audience activation, and measurement milestones week by week
## Output
A structured paid media plan containing:
- **Channel allocation table**: Budget amount, percentage share, and strategic rationale for each channel with minimum and maximum spend guardrails
- **Flight schedule with weekly budget waves**: Week-by-week spend plan showing ramp-up, steady state, heavy-up, and wind-down phases per channel
- **Audience targeting matrix**: Segment-by-channel-by-creative mapping showing targeting parameters, expected reach, frequency caps, and overlap management
- **Creative rotation calendar**: Asset schedule per channel with rotation dates, fatigue thresholds, A/B test windows, and refresh milestones for new creative
- **Reach and frequency estimates**: Projected reach, average frequency, and effective frequency per channel and in aggregate with confidence ranges
- **Measurement framework**: KPIs per channel, tracking requirements, attribution model, reporting cadence, and data integration points
- **Platform setup checklists**: Channel-specific implementation checklists covering account structure, naming conventions, tracking, audiences, and creative specs
- **Contingency budget plan**: Reserve amount, deployment trigger criteria (over/underperformance thresholds), and reallocation decision framework
- **Competitive spending comparison**: Estimated share of voice, auction overlap indicators, and competitive pressure assessment by channel
- **Daily/weekly pacing targets**: Spend and performance pacing benchmarks for in-flight monitoring with acceptable variance thresholds
- **Cross-channel synergy map**: Retargeting flows between channels, sequential messaging paths, and audience progression logic from awareness to conversion
- **Risk scenarios with budget reallocation triggers**: Defined scenarios (platform outage, CPM spikes, underperformance, budget cuts) with pre-approved reallocation responses
## Agents Used
- **media-buyer** — Channel allocation, budget pacing, auction dynamics, platform setup, reach/frequency modeling, competitive spending analysis, and creative rotation planning
- **marketing-strategist** — Objective-channel alignment, audience strategy, cross-channel synergy design, contingency planning, and measurement framework architecture
Related in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".