Ad Copy Character Counter
npx machina-cli add skill akhilkannur/marketing-agent-blueprints/ad-copy-character-counter --openclawThe Ad Variant Factory
Core Instructions
You are a highly specialized AI agent focusing on Paid Media. Your mission is: Counting characters is boring. This agent takes your rough draft headlines and automatically generates platform-perfect variants (Google, FB, LinkedIn) that fit the strict character limits while maximizing click-through rate.
Implementation Workflow
Phase 1: Initialization
- Check: Does
ad_seeds.csvexist? - If Missing: Create it.
- Load: Read the seeds.
Phase 2: The Creative Lab
For each row in the CSV:
- Analyze: What is the
Platformconstraint?- Google: Headline < 30 chars. Desc < 90 chars.
- Facebook: Headline < 40 chars. Primary Text < 125 chars.
- LinkedIn: Headline < 70 chars. Intro < 150 chars.
- Generate: Create 3 distinct angles for the
Seed_Headline:- Angle 1: Direct Benefit.
- Angle 2: Question/Curiosity.
- Angle 3: Social Proof/Authority.
- Validate: rigorously check the character count. If it fails, regenerate.
Phase 3: Output
- Compile: Save to
ad_variants_ready.csv. - Columns:
Platform,Angle,Headline,Headline_Len,Body_Copy. - Summary: "Generated [X] ad variants. All passed character limit checks."
Blueprint ID: ad-copy-character-counter Source: Real AI Examples
Source
git clone https://github.com/akhilkannur/marketing-agent-blueprints/blob/main/skills/ad-copy-character-counter/SKILL.mdView on GitHub Overview
Auto-generates platform-optimized ad variants from rough headlines for Google, Facebook, and LinkedIn. It enforces each platform’s character limits while aiming to maximize click-through rates. This workflow scales paid media creative with a repeatable seeds-and-variants process.
How This Skill Works
The agent loads seeds from ad_seeds.csv, evaluates platform constraints (Google: Headline < 30 chars, Desc < 90; Facebook: Headline < 40 chars, Primary Text < 125; LinkedIn: Headline < 70 chars, Intro < 150). For each seed it creates three angles: Direct Benefit, Question/Curiosity, and Social Proof/Authority, then validates lengths and regenerates as needed. Finally it writes ad_variants_ready.csv with columns Platform, Angle, Headline, Headline_Len, Body_Copy and a concise summary.
When to Use It
- You have rough draft headlines and need platform-optimized variants for Google, Facebook, or LinkedIn
- You must meet strict character limits while preserving message clarity
- You want three angles per seed to support A/B testing (Direct Benefit, Question/Curiosity, Social Proof/Authority)
- You want automated validation to regenerate any headline that misses constraints
- You need a repeatable workflow that outputs ad_variants_ready.csv for reporting
Quick Start
- Step 1: Ensure ad_seeds.csv exists (create it if missing).
- Step 2: Run the Ad Variant Factory to generate three angles per seed and validate lengths.
- Step 3: Open ad_variants_ready.csv to review Platform, Angle, Headline, Headline_Len, and Body_Copy; use for deployment.
Best Practices
- Start with seed headlines that clearly state a benefit to the reader
- Always map each platform’s constraints before generation and enforce them
- Generate three angles per seed to maximize testing options
- Let the validator regenerate any over-length headlines until they pass
- Record the computed Headline_Len and keep seeds organized for re-runs
Example Use Cases
- Google example: Seed 'Boost sales today' → Angle: Direct Benefit → Headline: 'Boost Sales Today' (18 chars); Body Copy: 'A quick tweak to lift CTR under 90 chars.'
- Facebook example: Seed 'Capture leads fast' → Angle: Question/Curiosity → Headline: 'Ready to capture more leads?' (28 chars); Body Copy: 'Three proven lines that fit 125 chars.'
- LinkedIn example: Seed 'Enterprise-ready marketing' → Angle: Social Proof/Authority → Headline: 'Trusted by 1,200+ teams' (24 chars); Body Copy: 'Professional audience-friendly intro under 150 chars.'
- Google example 2: Seed 'Scale your revenue' → Angle: Direct Benefit → Headline: 'Scale Revenue Now' (16 chars); Body Copy: 'Improve ROI with a single phrase change.'
- LinkedIn example 2: Seed 'B2B demand generation' → Angle: Question/Curiosity → Headline: 'Can your marketing convert more?' (33 chars); Body Copy: 'Lead with value in a concise intro under 150 chars.'