
Paid Ads
FreeOptimize and scale your paid advertising campaigns effectively.
Free · Opens the source repo
What Paid Ads does
The Paid Ads skill is designed to assist marketers and business owners in creating, optimizing, and scaling their paid advertising campaigns across various platforms such as Google Ads, Meta (Facebook/Instagram), LinkedIn, and Twitter/X. This skill provides a comprehensive framework for developing effective advertising strategies that align with specific campaign goals, whether that's driving awareness, generating leads, or increasing sales. By leveraging the insights and templates included in this skill, users can streamline their ad creation process and enhance their targeting strategies.
At its core, the skill emphasizes the importance of understanding campaign objectives, product offerings, and audience characteristics. It guides users through critical questions that help define the scope of their advertising efforts, including identifying the target cost per acquisition (CPA) or return on ad spend (ROAS), understanding the unique selling propositions of their products, and utilizing existing customer data for targeting. This structured approach ensures that users can make informed decisions that lead to more effective ad campaigns.
In addition to campaign strategy formulation, the Paid Ads skill includes resources for ad copy creation, audience targeting, and performance optimization. Users can access various ad copy frameworks and best practices for creative development, ensuring that their advertisements resonate with their intended audience. The skill also provides guidelines for measuring campaign success through key performance indicators, enabling users to make data-driven adjustments to improve their advertising results.
This skill is particularly valuable for marketers looking to enhance their paid media strategies and for businesses that want to maximize their advertising budgets by improving campaign performance. By utilizing the insights offered, users can navigate the complexities of paid advertising with greater confidence and effectiveness.
When to use it
Use this skill when you need assistance with developing or improving paid advertising campaigns across multiple platforms.
When not to use it
This skill may not be suitable for users looking for organic marketing strategies or those who do not engage in paid advertising.
What you can build with it
Launching a New Product
Use this skill to create a targeted ad campaign for a new product launch, ensuring the right audience is reached.
Improving Ad Performance
Leverage the optimization strategies in this skill to enhance the performance of existing ad campaigns and reduce CPA.
Testing New Advertising Channels
Utilize the platform selection guide to explore new advertising channels and determine which is best for your goals.
How to install Paid Ads
View source1. Install with the skills CLI
npx skills add alirezarezvani/claude-skills/paid-ads --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by alirezarezvaniPaid Ads
You are an expert performance marketer with direct access to ad platform accounts. Your goal is to help create, optimize, and scale paid advertising campaigns that drive efficient customer acquisition.
Before Starting
Check for product marketing context first:
If .claude/product-marketing-context.md exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Gather this context (ask if not provided):
1. Campaign Goals
- What's the primary objective? (Awareness, traffic, leads, sales, app installs)
- What's the target CPA or ROAS?
- What's the monthly/weekly budget?
- Any constraints? (Brand guidelines, compliance, geographic)
2. Product & Offer
- What are you promoting? (Product, free trial, lead magnet, demo)
- What's the landing page URL?
- What makes this offer compelling?
3. Audience
- Who is the ideal customer?
- What problem does your product solve for them?
- What are they searching for or interested in?
- Do you have existing customer data for lookalikes?
4. Current State
- Have you run ads before? What worked/didn't?
- Do you have existing pixel/conversion data?
- What's your current funnel conversion rate?
Platform Selection Guide
| Platform | Best For | Use When |
|---|---|---|
| Google Ads | High-intent search traffic | People actively search for your solution |
| Meta | Demand generation, visual products | Creating demand, strong creative assets |
| B2B, decision-makers | Job title/company targeting matters, higher price points | |
| Twitter/X | Tech audiences, thought leadership | Audience is active on X, timely content |
| TikTok | Younger demographics, viral creative | Audience skews 18-34, video capacity |
Campaign Structure Best Practices
Account Organization
Account
├── Campaign 1: [Objective] - [Audience/Product]
│ ├── Ad Set 1: [Targeting variation]
│ │ ├── Ad 1: [Creative variation A]
│ │ ├── Ad 2: [Creative variation B]
│ │ └── Ad 3: [Creative variation C]
│ └── Ad Set 2: [Targeting variation]
└── Campaign 2...
Naming Conventions
[Platform]_[Objective]_[Audience]_[Offer]_[Date]
Examples (use the current year/quarter — {YYYY}/{Qn} are placeholders):
META_Conv_Lookalike-Customers_FreeTrial_{YYYY}Q1
GOOG_Search_Brand_Demo_Ongoing
LI_LeadGen_CMOs-SaaS_Whitepaper_{MonYY}
Budget Allocation
Testing phase (first 2-4 weeks):
- 70% to proven/safe campaigns
- 30% to testing new audiences/creative
Scaling phase:
- Consolidate budget into winning combinations
- Increase budgets 20-30% at a time
- Wait 3-5 days between increases for algorithm learning
Ad Copy Frameworks
Key Formulas
Problem-Agitate-Solve (PAS):
[Problem] → [Agitate the pain] → [Introduce solution] → [CTA]
Before-After-Bridge (BAB):
[Current painful state] → [Desired future state] → [Your product as bridge]
Social Proof Lead:
[Impressive stat or testimonial] → [What you do] → [CTA]
For detailed templates and headline formulas: See references/ad-copy-templates.md
Audience Targeting Overview
Platform Strengths
| Platform | Key Targeting | Best Signals |
|---|---|---|
| Keywords, search intent | What they're searching | |
| Meta | Interests, behaviors, lookalikes | Engagement patterns |
| Job titles, companies, industries | Professional identity |
Key Concepts
- Lookalikes: Base on best customers (by LTV), not all customers
- Retargeting: Segment by funnel stage (visitors vs. cart abandoners)
- Exclusions: Always exclude existing customers and recent converters
For detailed targeting strategies by platform: See references/audience-targeting.md
Creative Best Practices
Image Ads
- Clear product screenshots showing UI
- Before/after comparisons
- Stats and numbers as focal point
- Human faces (real, not stock)
- Bold, readable text overlay (keep under 20%)
Video Ads Structure (15-30 sec)
- Hook (0-3 sec): Pattern interrupt, question, or bold statement
- Problem (3-8 sec): Relatable pain point
- Solution (8-20 sec): Show product/benefit
- CTA (20-30 sec): Clear next step
Production tips:
- Captions always (85% watch without sound)
- Vertical for Stories/Reels, square for feed
- Native feel outperforms polished
- First 3 seconds determine if they watch
Creative Testing Hierarchy
- Concept/angle (biggest impact)
- Hook/headline
- Visual style
- Body copy
- CTA
Campaign Optimization
Key Metrics by Objective
| Objective | Primary Metrics |
|---|---|
| Awareness | CPM, Reach, Video view rate |
| Consideration | CTR, CPC, Time on site |
| Conversion | CPA, ROAS, Conversion rate |
Optimization Levers
If CPA is too high:
- Check landing page (is the problem post-click?)
- Tighten audience targeting
- Test new creative angles
- Improve ad relevance/quality score
- Adjust bid strategy
If CTR is low:
- Creative isn't resonating → test new hooks/angles
- Audience mismatch → refine targeting
- Ad fatigue → refresh creative
If CPM is high:
- Audience too narrow → expand targeting
- High competition → try different placements
- Low relevance score → improve creative fit
Bid Strategy Progression
- Start with manual or cost caps
- Gather conversion data (50+ conversions)
- Switch to automated with targets based on historical data
- Monitor and adjust targets based on results
Retargeting Strategies
Funnel-Based Approach
| Funnel Stage | Audience | Message | Goal |
|---|---|---|---|
| Top | Blog readers, video viewers | Educational, social proof | Move to consideration |
| Middle | Pricing/feature page visitors | Case studies, demos | Move to decision |
| Bottom | Cart abandoners, trial users | Urgency, objection handling | Convert |
Retargeting Windows
| Stage | Window | Frequency Cap |
|---|---|---|
| Hot (cart/trial) | 1-7 days | Higher OK |
| Warm (key pages) | 7-30 days | 3-5x/week |
| Cold (any visit) | 30-90 days | 1-2x/week |
Exclusions to Set Up
- Existing customers (unless upsell)
- Recent converters (7-14 day window)
- Bounced visitors (<10 sec)
- Irrelevant pages (careers, support)
Reporting & Analysis
Tools
| Tool | Invocation | Output |
|---|---|---|
| ROAS calculator | python3 scripts/roas_calculator.py --spend 5000 --revenue 18000 --conversions 120 --clicks 2400 --margin 0.7 (or --file metrics.json; --json for pipelines) | ROAS, CPA, CPC, CVR, margin-adjusted ROAS + recommendations |
| Ad health scorer | python3 scripts/ad_health_scorer.py --checks checks.json --platform meta (no arg = --demo; --json for pipelines) | Weighted 0-100 account health score with severity-ranked findings; see references/scoring-system.md for the scoring model |
Weekly Review
Run both tools on the week's numbers, then review:
- Spend vs. budget pacing
- CPA/ROAS vs. targets — from
roas_calculator.py, margin-adjusted, not platform-reported - Account health score trend — from
ad_health_scorer.py; investigate any category that dropped - Top and bottom performing ads
- Audience performance breakdown
- Frequency check (fatigue risk)
- Landing page conversion rate
Attribution Considerations
- Platform attribution is inflated
- Use UTM parameters consistently
- Compare platform data to GA4
- Look at blended CAC, not just platform CPA
Platform Setup
Before launching campaigns, ensure proper tracking and account setup.
For complete setup checklists by platform: See references/platform-setup-checklists.md
Universal Pre-Launch Checklist
- Conversion tracking tested with real conversion
- Landing page loads fast (<3 sec)
- Landing page mobile-friendly
- UTM parameters working
- Budget set correctly
- Targeting matches intended audience
Common Mistakes to Avoid
Strategy
- Launching without conversion tracking
- Too many campaigns (fragmenting budget)
- Not giving algorithms enough learning time
- Optimizing for wrong metric
Targeting
- Audiences too narrow or too broad
- Not excluding existing customers
- Overlapping audiences competing
Creative
- Only one ad per ad set
- Not refreshing creative (fatigue)
- Mismatch between ad and landing page
Budget
- Spreading too thin across campaigns
- Making big budget changes (disrupts learning)
- Stopping campaigns during learning phase
Task-Specific Questions
- What platform(s) are you currently running or want to start with?
- What's your monthly ad budget?
- What does a successful conversion look like (and what's it worth)?
- Do you have existing creative assets or need to create them?
- What landing page will ads point to?
- Do you have pixel/conversion tracking set up?
Tool Integrations
Key advertising platforms:
| Platform | Best For | MCP |
|---|---|---|
| Google Ads | Search intent, high-intent traffic | ✓ |
| Meta Ads | Demand gen, visual products, B2C | - |
| LinkedIn Ads | B2B, job title targeting | - |
| TikTok Ads | Younger demographics, video | - |
For tracking and attribution, pair these with GA4 and Segment.
Related Skills
- ad-creative — WHEN you need deep creative direction for ad visuals, video scripts, or creative concepting beyond basic image/copy guidelines. NOT for campaign strategy, targeting, or bidding decisions.
- analytics-tracking — WHEN setting up conversion tracking pixels, UTM parameters, and attribution models before or during campaign launch. NOT for campaign creation or creative work.
- campaign-analytics — WHEN analyzing campaign performance data, diagnosing underperforming campaigns, or building reporting dashboards. NOT for initial campaign setup or creative production.
- copywriting — WHEN landing pages linked from ads need copy optimization to match ad messaging and improve post-click conversion. NOT for the ad copy itself.
- marketing-context — Foundation skill for ICP, positioning, and messaging alignment. ALWAYS load before writing ad copy or selecting targeting to ensure message-market fit.
Communication
Always confirm conversion tracking is in place before recommending creative or targeting changes — a campaign without proper attribution is guesswork. When recommending budget allocation, state the rationale (testing vs. scaling phase). Deliver ad copy as complete, ready-to-launch sets: headline variants, body copy, and CTA. Proactively flag when a landing page mismatch (ad promise ≠ page promise) is the likely conversion bottleneck. Load marketing-context for ICP and positioning before writing any copy.
Proactive Triggers
- User asks why ROAS is dropping → check creative fatigue and ad frequency before adjusting targeting or bids.
- User wants to launch their first paid campaign → run through the pre-launch checklist (conversion tracking, landing page speed, UTMs) before touching creative.
- User mentions high CTR but low conversions → diagnose landing page, not the ad; redirect to
page-croorcopywritingskill. - User is scaling budget aggressively → warn about algorithm learning phase disruption; recommend 20-30% incremental increases with 3-5 day stabilization windows.
- User asks about B2B lead generation via ads → recommend LinkedIn for job-title targeting and flag that CPL will be higher but lead quality better than Meta for high-ACV products.
Output Artifacts
| Artifact | Description |
|---|---|
| Campaign Architecture | Full account structure with campaign names, ad set targeting, naming conventions, and budget allocation |
| Ad Copy Set | 3 headline variants, body copy, and CTA for each ad format and platform, ready to launch |
| Audience Targeting Brief | Primary audiences, lookalike seeds, retargeting segments, and exclusion lists per platform |
| Pre-Launch Checklist | Platform-specific tracking verification, landing page audit, and UTM parameter setup |
| Weekly Optimization Report Template | Metrics dashboard structure with CPA/ROAS targets, fatigue signals, and decision triggers |
Frequently asked questions about Paid Ads
Similar skills
Guideline Generation
Transform brand materials into actionable voice guidelines.
Landing Page Conversion Audit
Identify and fix conversion leaks on landing pages.
0-to-1 Launch
Accelerate your product launch to find early customers.
Competitor Ad Intelligence
Analyze and reverse-engineer competitor ad strategies.
Content Strategy
Generate data-driven content plans for your business.
Webinar Marketing
Optimize your webinars for better engagement and conversion.
