Agent skill

Paid Ads

by borghei in borghei/Claude-Skills

Plan, execute, and optimize paid ad campaigns across Google, Meta, LinkedIn, Twitter/X, and TikTok, covering targeting, budget, bid strategies, and retargeting.

MITAuto-check passedMarketing & SEO

Install Paid Ads

skills CLI
$ npx skills add borghei/Claude-Skills --skill paid-ads -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills paid-ads --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing/paid-ads .claude/skills/paid-ads && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
paid-ads
GitHub stars
891
Token cost
~6.9k tokens
SKILL.md length
2,893 words
Files
4 (incl. scripts)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Plan, execute, and optimize paid ad campaigns across Google, Meta, LinkedIn, Twitter/X, and TikTok, covering targeting, budget, bid strategies, and retargeting.

  • Works in 3 steps: Ad Copy Scorer (scripts/ad_copy_scorer.py) → CPC / CPA / ROAS Calculator… → Audience Sizer (scripts/audience_sizer.py)
  • Running PPC campaigns
  • SKILL.md covers Table of Contents, Keywords, Clarify First and Quick Start, plus 7 more sections
  • Runs Python scripts from its folder; calls python

What it does

Paid Ads is an agent skill from borghei/Claude-Skills. Plan, execute, and optimize paid ad campaigns across Google, Meta, LinkedIn, Twitter/X, and TikTok, covering targeting, budget, bid strategies, and retargeting. Use when running PPC campaigns, setting up ad accounts, or optimizing ROAS/CPA.

Its SKILL.md is about 6.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/ad_copy_scorer.py`, `scripts/audience_sizer.py` and `scripts/cpc_calculator.py`).

It sits in Marketing & SEO, covering Paid advertising. It works with X (Twitter), LinkedIn, TikTok and Meta Ads. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Running PPC campaigns
  • Setting up ad accounts
  • Optimizing ROAS/CPA

Example prompts

  • “/paid-ads”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Ad Copy Scorer (scripts/ad_copy_scorer.py)
  2. CPC / CPA / ROAS Calculator (scripts/cpc_calculator.py)
  3. Audience Sizer (scripts/audience_sizer.py)

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • support.google.com
    • facebook.com
    • developers.facebook.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Paid Ads loads about 6.9k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 2,893 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~6.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 2,893 words, ~6,857 tokens.

Download SKILL.mdSave it as .claude/skills/paid-ads/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
paid-ads
description
Plan, execute, and optimize paid ad campaigns across Google, Meta, LinkedIn, Twitter/X, and TikTok, covering targeting, budget, bid strategies, and retargeting. Use when running PPC campaigns, setting up ad accounts, or optimizing ROAS/CPA.
license
MIT
metadata.version
1.0.0
metadata.author
borghei
metadata.category
marketing
metadata.domain
advertising
metadata.updated
2026-09-21

Paid Ads

Campaign strategy, audience targeting, budget optimization, and performance management across all major advertising platforms.


Table of Contents


Keywords

paid ads, PPC, pay-per-click, Google Ads, Meta Ads, Facebook Ads, Instagram Ads, LinkedIn Ads, Twitter Ads, TikTok Ads, paid media, ROAS, CPA, CPC, CPM, audience targeting, retargeting, remarketing, budget optimization, bid strategy, ad campaigns, conversion tracking, lookalike audiences, campaign structure, ad performance, paid search, paid social


Clarify First

Before building the campaign, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Campaign objective — leads, sales, traffic, or awareness (drives platform selection, campaign type, bid strategy, and success metrics)
  • Target audience — who they are and their intent signal (drives platform selection and targeting setup)
  • Monthly budget — total spend available (determines viable platforms, bid-strategy stage, and budget-phase allocation)
  • Conversion action & offer — the action you are paying for and the offer behind it (drives campaign structure, tracking, and ad-to-page match)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Quick Start

Launch a Campaign
  1. Define campaign goal (leads, sales, traffic, awareness)
  2. Select platform based on audience and intent
  3. Set up conversion tracking and verify with test conversion
  4. Build campaign structure with proper naming conventions
  5. Define audience targeting
  6. Set budget and bid strategy
  7. Create ad creative (use Ad Creative skill)
  8. Launch and monitor for 7 days before making changes
Optimize an Existing Campaign
  1. Pull performance data for last 14-30 days
  2. Identify primary issue (high CPA, low CTR, low ROAS)
  3. Use the optimization levers in the Performance Optimization section
  4. Make one change at a time, wait 3-5 days between changes
  5. Document every change and its impact

Platform Selection Guide

Platform Comparison
PlatformBest ForAudience SignalTypical CPCMinimum Budget
Google SearchHigh-intent demand captureSearch keywords (what they want now)$1-8 (B2B: $5-20)$1,500/mo
Google DisplayAwareness, retargetingBrowsing behavior, interests$0.30-1.50$1,000/mo
Google Performance MaxMulti-format automationMixed signals, Google's MLVaries$2,000/mo
Meta (FB/IG)Demand generation, B2C, visual productsInterests, behaviors, lookalikes$0.50-3.00$1,000/mo
LinkedInB2B, decision-maker targetingJob title, company, industry, seniority$5-15$2,000/mo
Twitter/XTech audiences, thought leadershipFollowers, interests, keywords$0.50-3.00$500/mo
TikTok18-34 demographics, brand awarenessInterests, behaviors, creator affinity$0.30-1.50$1,000/mo
RedditNiche communities, tech/gamingSubreddit targeting$0.50-2.00$500/mo
Platform Selection Decision Tree
Is the audience actively searching for your solution?
├── Yes → Google Search Ads
└── No → Do you know their job title or company?
    ├── Yes → LinkedIn Ads (B2B) or Meta Ads (B2C)
    └── No → Is your product visual or lifestyle?
        ├── Yes → Meta Ads (Instagram) or TikTok
        └── No → Is your audience technical?
            ├── Yes → Reddit Ads or Twitter/X
            └── No → Meta Ads (Facebook) or Google Display

Campaign Structure Framework

Account Hierarchy
Account
├── Campaign 1: [Objective] - [Product/Offer]
│   ├── Ad Group/Set 1: [Audience Segment A]
│   │   ├── Ad 1: [Creative Variant 1]
│   │   ├── Ad 2: [Creative Variant 2]
│   │   └── Ad 3: [Creative Variant 3]
│   └── Ad Group/Set 2: [Audience Segment B]
│       ├── Ad 1: [Creative Variant 1]
│       └── Ad 2: [Creative Variant 2]
└── Campaign 2: [Objective] - [Product/Offer]
Naming Conventions
[Platform]_[Objective]_[Audience]_[Offer]_[Date]

Examples:
GOOG_Search_Brand_FreeTrial_2026Q1
META_Conv_Lookalike-Customers_Demo_Mar26
LI_LeadGen_CMOs-SaaS-500_Whitepaper_2026Q1
TIKTOK_Aware_18-34-Tech_BrandVideo_Mar26
Campaign Types by Objective
ObjectiveGoogleMetaLinkedIn
AwarenessDisplay, YouTube, PMaxReach, Video ViewsBrand Awareness
ConsiderationSearch, DisplayTraffic, EngagementWebsite Visits
ConversionSearch, PMaxConversions, LeadsLead Gen Forms
RetargetingDisplay, Search (RLSA)Custom AudiencesMatched Audiences

Audience Targeting by Platform

Google Ads Targeting
Targeting TypeUse WhenHow
Keyword targetingCapturing search intentExact, phrase, and broad match keywords
Audience targetingLayering intent signalsIn-market, affinity, custom intent
RLSARetargeting in searchWebsite visitor lists on search campaigns
Customer MatchTargeting known contactsUpload email lists for matched targeting
Optimized targeting / audience signalsExpanding from known customersSimilar audiences were retired in Aug 2023. Use optimized targeting (Display, Demand Gen), audience signals (Performance Max), or Lookalike segments seeded from Customer Match / site visitors (Demand Gen, Video)

Keyword match type strategy:

  • Exact match [keyword]: Highest intent, lowest volume, highest CPC
  • Phrase match "keyword": Medium intent, medium volume
  • Broad match keyword: Lowest intent, highest volume, lowest CPC (use with smart bidding)
Meta Ads Targeting
Targeting TypeUse WhenHow
Interest targetingCold prospectingLayer 2-3 related interests
Lookalike audiencesExpanding from customers1-3% lookalike from best customers (by LTV); in Advantage+ audience, lookalikes act as suggestions, not hard limits
Custom audiencesRetargetingWebsite visitors, email lists, video viewers
Broad targeting / Advantage+ audienceTrusting Meta's MLOnly audience controls (location, minimum age, language, custom audience exclusions) are hard limits; everything else is a suggestion
Detailed targetingNarrow audience neededCombine demographics + interests + behaviors

Lookalike best practices:

  • Seed with best customers (by LTV), not all customers
  • Start with 1% lookalike (most similar), expand to 3-5% once proven
  • Create separate lookalikes from different seeds (customers, trial users, email subscribers)
LinkedIn Ads Targeting
Targeting TypeUse WhenHow
Job titleTargeting decision-makersSpecific titles (CMO, VP Marketing, Head of Growth)
Job functionBroader role targetingMarketing, Engineering, Finance
Company sizeEnterprise vs. SMBEmployee count ranges
IndustryVertical-specific campaignsLinkedIn's industry categories
SeniorityC-suite vs. individual contributorManager, Director, VP, CXO
SkillsTechnical targetingListed skills on profiles
Company listABM targetingUpload target account lists

LinkedIn targeting rules:

  • Minimum audience size: 50,000 for awareness, 20,000 for conversion
  • Layer 2-3 targeting dimensions maximum (more layers = too narrow)
  • Exclude competitors, agencies, and job seekers if not relevant

Automated Campaign Types

Both Google and Meta now default new campaigns toward AI-driven, goal-based formats. Treat them as a trade: you give up placement, query, and audience control in exchange for reach and machine optimization. Feed them good inputs and set guardrails. (As of September 2026 — these products change frequently; check each platform's help center before launch.)

Campaign typePlatformWhat it doesWhat you give up
Advantage+ sales / app / leads campaignsMetaEnd-to-end automation of audience, placements, budget, and creative combinations for the sales, app promotion, and leads objectivesDetailed targeting becomes suggestions; placement and budget split handled by Meta
Advantage+ audienceMetaUses your audience inputs as suggestions and expands beyond them when likely to improve resultsInterests/lookalikes are no longer limits — only location, minimum age, language, and custom audience exclusions are hard controls
Performance MaxGoogleOne goal-based campaign across Search, Shopping, YouTube, Display, Discover, Gmail, and MapsChannel mix and most placement choice; audience signals guide learning but are not targeting
AI Max for Search (2025)GoogleOptimization layer on a Search campaign: search term matching beyond your keywords (broad match + keywordless), text customization, final URL expansionExact query control; generated headlines/descriptions; landing-page choice (if URL expansion is on)
Demand GenGoogleVisual/video campaigns on YouTube (incl. Shorts), Discover, Gmail, and Display with Lookalike segments and optimized targetingFine placement control; lookalike reach can extend past seed similarity

Ads in AI Overviews and AI Mode (Google): there is no separate campaign type and no direct placement targeting. Text and Shopping ads from Search (with broad match or AI Max), Shopping, and Performance Max campaigns are eligible automatically; you cannot opt out, and Google Ads does not segment AI Overview ad reporting. Ads within AI Overviews are limited to English in a subset of countries (incl. the US), while ads above/below AI Overviews run in all AI Overview markets. (About ads and AI Overviews)

When to use automated campaigns:

  • Conversion tracking is verified and the account has steady conversion volume (automation learns from your conversion data)
  • You can supply creative volume (multiple images, videos, headlines per asset group / ad set)
  • You have a tested manual baseline to compare against — run as an experiment where the platform supports it (e.g., AI Max experiments)

How to feed them:

  • Conversion quality — optimize for the event that correlates with revenue (qualified lead, purchase, value), not cheap proxies (page views, form starts). Pass values and import offline conversions / CAPI events so the model learns from real outcomes.
  • Creative volume and variety — supply all asset types; refresh fatigued assets rather than restarting campaigns.
  • Audience signals — Customer Match lists, converters, and site-visitor lists as signals (Google) or suggestions (Meta).

Guardrails:

GuardrailGoogleMeta
Brand trafficBrand exclusions (PMax, Search/AI Max); brand inclusions in AI MaxExclude existing-customer custom audiences
Query controlAccount- and campaign-level negative keywords (PMax negatives apply to Search/Shopping inventory)n/a
Landing pagesTurn off final URL expansion or use URL exclusions / URL inclusionsSet destination per ad
Audience limitsLocation and language settingsAudience controls: location, minimum age, language, custom audience exclusions
ReportingPMax channel performance and search terms reports; AI Max search terms reportingBreakdowns by placement/age/gender

Sources: About Performance Max, About AI Max for Search, How AI Max works, Brand exclusions, Demand Gen Lookalike segments, Meta Advantage+, Advantage+ audience.


Budget Allocation Strategy

Budget by Campaign Phase

Phase 1: Testing (Weeks 1-4)

AllocationPurpose
40%Proven/safe campaigns (brand search, retargeting)
40%Testing new audiences and creative
20%Experimental channels or formats

Phase 2: Optimization (Weeks 5-8)

AllocationPurpose
60%Winning combinations from testing
25%Iterating on promising but unproven
15%New tests

Phase 3: Scaling (Weeks 9+)

AllocationPurpose
70%Proven performers
20%Expansion (new audiences, lookalikes, broader targeting)
10%Ongoing testing
Budget Scaling Rules
  • Increase budget by 20-30% at a time, never more
  • Wait 3-5 days between increases for algorithm learning
  • Monitor CPA for 48 hours after increase — if CPA spikes, hold
  • Never double a budget overnight (disrupts algorithm learning)
  • If CPA increases > 30% after scaling, revert and investigate
Budget Minimums by Platform
PlatformMinimum Viable Monthly BudgetOptimal Monthly Budget
Google Search$1,500$5,000+
Google Display$1,000$3,000+
Meta Ads$1,000$3,000+
LinkedIn Ads$2,000$5,000+
TikTok Ads$1,000$3,000+
Reddit Ads$500$2,000+

Bid Strategy Progression

Strategy Ladder
StageStrategyWhen to UseRequirements
1Manual CPCStarting out, need controlNone
2Max ClicksBuilding traffic dataBudget cap set
3Target CPAOptimizing for conversions30+ conversions/month
4Target ROASOptimizing for revenue50+ conversions/month + revenue data
5Value-basedMaximizing revenueConversion value tracking, 100+ conversions/month
Bid Strategy Rules
  • Start with Manual CPC or Max Clicks until you have conversion data
  • Switch to automated bidding after 30+ conversions in 30 days
  • Set CPA targets 10-20% above your actual target (give the algorithm room)
  • Never change bid strategy and creative at the same time
  • Allow 14 days of learning phase after switching strategies

Retargeting Playbook

Funnel-Based Retargeting
Funnel StageAudienceMessageWindowFrequency
TopBlog readers, video viewersEducational, social proof30-90 days1-2x/week
MiddlePricing/feature page visitorsCase studies, demos, comparisons7-30 days3-5x/week
BottomCart/trial abandonersUrgency, objection handling, offer1-7 daysDaily OK
Retargeting Audience Setup
AudienceSourcePlatformPriority
All website visitors (30 days)PixelAll platformsMedium
Pricing page visitors (14 days)PixelAll platformsHigh
Cart/trial abandoners (7 days)Pixel + EventsAll platformsHighest
Email subscribers (non-customers)Email listMeta, LinkedInMedium
Video viewers (50%+ watched)Platform eventMeta, YouTubeMedium
Blog readers (engaged, 60s+)Pixel + EventsAll platformsLow-Medium
Show full SKILL.md (1,154 more words)Show less
Exclusions (Critical)

Always exclude:

  • Existing paying customers (unless running upsell campaigns)
  • Recent converters (7-14 day exclusion window)
  • Bounced visitors (under 10 seconds on site)
  • Irrelevant page visitors (careers, support, legal)
  • Competitor employees (LinkedIn)

Performance Optimization

Optimization Decision Tree
Is CPA above target?
├── CTR is low (< 1% search, < 0.5% social)
│   ├── Creative fatigue? → Refresh creative
│   ├── Audience mismatch? → Refine targeting
│   └── Ad relevance low? → Improve message match
├── CTR is good, conversion rate low
│   ├── Landing page issue? → Audit page (speed, copy, CTA)
│   ├── Offer mismatch? → Align ad promise with page offer
│   └── Audience too broad? → Narrow targeting
└── CTR and CVR are good, CPA still high
    ├── CPM too high? → Try different placements/platforms
    ├── Competition driving up bids? → Adjust bid strategy
    └── Attribution issue? → Check conversion tracking
Key Metrics by Objective
ObjectivePrimary MetricsBenchmarks (B2B SaaS)
AwarenessCPM, Reach, Video View RateCPM: $5-15, VVR: 15-25%
ConsiderationCTR, CPC, Time on SiteCTR: 1-3%, CPC: $2-8
ConversionCPA, ROAS, Conversion RateCPA: $50-200, CR: 2-5%
RetargetingCPA, ROAS, FrequencyCPA: 30-50% lower than prospecting
Creative Fatigue Detection
SignalThresholdAction
CTR declining week over week20%+ decline over 2 weeksRefresh creative
Frequency above threshold> 3 (display), > 5 (retargeting)Expand audience or refresh
CPA increasing with stable CTR15%+ increase over 2 weeksTest new creative angles
Engagement rate dropping30%+ declineFull creative overhaul
Weekly Optimization Routine
TaskTimeWhat to Check
Budget pacing5 minSpend vs. plan, daily/weekly trends
CPA/ROAS check10 minPerformance vs. targets, by campaign
Top/bottom performers10 minPause worst, scale best
Audience analysis10 minWhich segments are converting?
Creative performance10 minCTR by creative, fatigue signals
Frequency check5 minAny audiences over-exposed?
Landing page CVR5 minPost-click conversion rate
Competitor check5 minNew competitors in auction?

Attribution and Measurement

Attribution Reality Check
What Platforms ReportReality
"This campaign drove 100 conversions"Platform attribution is inflated by 20-50%
"ROAS is 5x"Likely includes assisted conversions that would have converted anyway
Last-click attributionIgnores all touchpoints before the final click
View-through conversionsOften just people who would have converted regardless

Meta attribution windows (as of September 2026): Meta stopped returning the 7-day view and 28-day view windows on January 12, 2026. The remaining windows are 1-day click, 7-day click, 28-day click (Insights API), 1-day engaged view, and 1-day view (Meta for Developers, Oct 2025). Historical reports that used 7- or 28-day view will not match current numbers — note the break in any trend line.

Practical Attribution Approach
  1. Use UTM parameters consistently — Tag every campaign, ad, and link
  2. Track in GA4 as source of truth — Compare platform data to GA4
  3. Calculate blended CAC — Total marketing spend / Total new customers
  4. Use incrementality testing — Hold-out tests to measure true lift
  5. Compare platform data vs. CRM data — The gap is your attribution inflation
UTM Standards
utm_source: google | meta | linkedin | twitter | tiktok | reddit
utm_medium: cpc | paid-social | display | video | sponsored
utm_campaign: [campaign-name-lowercase-hyphenated]
utm_content: [ad-variant-identifier]
utm_term: [keyword] (search only)

Pre-Launch Checklist

Tracking
  • Pixel/tag installed and firing correctly
  • Conversion events defined and tested with real test conversion
  • UTM parameters added to all ad destination URLs
  • GA4 goals/events configured to match conversion events
  • Attribution window set appropriately and documented (e.g., Meta: 7-day click + 1-day view; 7-/28-day view windows no longer exist)
Landing Page
  • Page loads under 3 seconds on mobile
  • Page is mobile-responsive
  • Headline matches the ad message
  • CTA is above the fold on mobile
  • Form works and submits to CRM/email system
  • Thank you page/event fires conversion tracking
Campaign Setup
  • Budget set correctly (daily or lifetime)
  • Bid strategy selected and configured
  • Audience targeting reviewed (not too broad or narrow)
  • Negative keywords added (Google Search)
  • Exclusions configured (existing customers, competitors)
  • Ad schedule set (if time-specific targeting needed)
  • Geographic targeting verified
  • Device targeting reviewed
Creative
  • 3+ creative variants per ad group/set
  • All creative meets platform specifications
  • Copy validated against platform policies
  • Landing page URL correct for each ad

Best Practices

  1. Tracking first, creative second — Never launch without verified conversion tracking. A campaign without attribution is guesswork.

  2. Start narrow, expand gradually — Begin with your highest-intent, most-defined audience. Expand after proving the funnel works.

  3. One change at a time — Changing audience, creative, and bid strategy simultaneously makes it impossible to know what worked.

  4. Give algorithms time — Do not judge campaign performance before the learning phase completes (typically 50 conversions or 7 days).

  5. Creative is the biggest lever — On most platforms, creative quality matters more than targeting precision. Test creative aggressively.

  6. Match ad to landing page — The #1 conversion killer is mismatched expectations between ad and landing page.

  7. Budget concentration beats distribution — $3,000 on one proven platform outperforms $500 spread across six platforms.

  8. Build retargeting from day one — Install pixels and build audiences even before you spend on retargeting.

  9. Compare platform data to reality — Platform-reported conversions are always higher than actual. Use CRM and GA4 as the source of truth.

  10. Document everything — Every campaign change, test result, and learning should be recorded. Institutional knowledge prevents repeating mistakes.


Integration Points

  • Ad Creative — Use for writing ad copy, generating headlines, and creating creative variations. Paid Ads handles the campaign strategy; Ad Creative handles the copy.
  • Landing Page Generator — Use for building the landing pages ads drive traffic to.
  • Campaign Analytics — Use for measuring campaign performance, attribution analysis, and ROI calculation.
  • Marketing Context — Use as foundation for audience targeting and messaging alignment.
  • Marketing Psychology — Apply psychological principles to improve ad creative and landing page conversion.
  • Copywriting — Use for optimizing landing page copy to improve post-click conversion rates.

Troubleshooting

SymptomLikely CauseFix
CPA above target with low CTRCreative fatigue or audience mismatchRefresh creative. Use ad_copy_scorer.py to validate new copy.
CPA above target with good CTRLanding page conversion issueAudit post-click experience: message match, page speed, form friction.
CTR dropping week over weekCreative fatigue (>3 frequency)Refresh creative every 2-4 weeks. Expand audience to reduce frequency.
Budget not spendingAudience too narrow or bid too lowCheck audience size with audience_sizer.py. Increase bid 10-20%.
Platform reports inflated conversionsAttribution window too wideCompare platform data to GA4/CRM. Use incrementality testing for true lift.
Performance Max underperformingInsufficient or low-quality conversion dataBuild steady conversion volume first (start with Search), optimize to a revenue-linked conversion, and add brand exclusions + negatives so PMax is not just harvesting branded traffic.
CPA spikes after budget increaseAlgorithm learning disruptedNever increase budget more than 20-30% at a time. Wait 3-5 days between changes.

Success Criteria

  • CPA within target range for campaign objective (B2B SaaS: $50-200 for qualified leads)
  • ROAS above 3x for revenue-focused campaigns
  • CTR above platform benchmarks: 2-5% search, 0.5-2% social
  • Conversion tracking verified with test conversion before launch
  • Budget allocation: 70% proven / 20% expansion / 10% testing (at scale)
  • All campaigns have proper UTM tagging and GA4 attribution configured
  • Weekly optimization routine completed with documented changes

Scope & Limitations

In Scope: Campaign strategy, platform selection, audience targeting, budget allocation, bid strategies, retargeting, performance optimization, attribution, pre-launch checklists.

Out of Scope: Ad copy writing (use ad-creative), landing page design (use landing-page-generator), creative design/production, marketing automation, CRM configuration.

Limitations: Budget minimums and CPC benchmarks are directional estimates. Actual costs vary by industry, geography, and competition. Platform-reported metrics are typically 20-50% inflated versus CRM truth.


Python Automation Tools

1. Ad Copy Scorer (scripts/ad_copy_scorer.py)

Scores ad copy against platform specs, compliance rules, and conversion best practices.

bash
python scripts/ad_copy_scorer.py --headline "Cut churn by 30%" --description "See how 1200 SaaS teams reduced churn" --platform google
python scripts/ad_copy_scorer.py --file ads.json --json
2. CPC / CPA / ROAS Calculator (scripts/cpc_calculator.py)

Calculates key advertising metrics from campaign data with industry benchmarks.

bash
python scripts/cpc_calculator.py --spend 5000 --clicks 1200 --conversions 45 --revenue 12000 --platform meta
python scripts/cpc_calculator.py --file campaign.json --json
3. Audience Sizer (scripts/audience_sizer.py)

Estimates target audience size and recommends budget based on platform and targeting criteria.

bash
python scripts/audience_sizer.py --platform linkedin --targeting "CMOs at SaaS companies 50-500 employees"
python scripts/audience_sizer.py --file targeting.json --json

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in marketing/paid-ads of borghei/Claude-Skills.

  • SKILL.md
  • scripts/ad_copy_scorer.py
  • scripts/audience_sizer.py
  • scripts/cpc_calculator.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Paid Ads next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Paid Ads compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paid Ads this skillborghei/Claude-Skills891—~6.9kAutomated safety check: PassMIT
AdsCesarjoquin/Marketing-Skills2021 repos~3.5kAutomated safety check: PassMIT
Adscoreyhaines31/marketingskills54k1 repos~7kAutomated safety check: PassMIT
Money Adsiamzifei/show-me-the-money1k—~2.4kAutomated safety check: PassCustom licence
Mena Adsgrowthack88/growth-marketing-os116—~2.5kAutomated safety check: PassMIT
Write Provider Skillsuperdesigndev/treg4.9k—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Ads

    Cesarjoquin/Marketing-Skills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    202 GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed
  • Ads

    coreyhaines31/marketingskills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    54k GitHub starsUsed in 1 repo~7k tokens
    Marketing & SEOAuto-check passed
  • Money Ads

    iamzifei/show-me-the-money

    Paid advertising automation for Google Ads, Meta Ads, and other ad platforms.

    1k GitHub stars~2.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Mena Ads

    growthack88/growth-marketing-os

    MENA Ads Command Center — a complete paid-ads operating system for the Arab world (Egypt, KSA, UAE, GCC, Levant, North Africa) and global accounts.

    116 GitHub stars~2.5k tokensUpdated 7 days ago
    Marketing & SEOAuto-check passed
  • Write Provider Skill

    superdesigndev/treg

    Build a treg provider skill — the endpoint map + mistake map that lets an agent do real work on a platform API through treg's proxy.

    4.9k GitHub stars~1.7k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Ad Copywriter

    rongxinzy/RongxinAI

    广告创意写作与优化技能,覆盖标题、描述、正文及完整广告方案的生成与迭代,适用于Google Ads、Meta、LinkedIn、TikTok、Twitter/X等主流付费广告平台。当用户需要撰写广告文案、进行创意生成、标题撰写,或请求批量生产广告变体、基于数据进行创意测试与效果优化时触发。

    154 GitHub stars~1.4k tokensUpdated today
    Marketing & SEOAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    891 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    891 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    891 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    891 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    891 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    891 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Paid Ads

What does Paid Ads do?

Plan, execute, and optimize paid ad campaigns across Google, Meta, LinkedIn, Twitter/X, and TikTok, covering targeting, budget, bid strategies, and retargeting. Paid Ads is an agent skill from borghei/Claude-Skills. Plan, execute, and optimize paid ad campaigns across Google, Meta, LinkedIn, Twitter/X, and TikTok, covering targeting, budget, bid strategies, and retargeting.

When should I use Paid Ads?

Paid Ads fits situations like: running PPC campaigns; setting up ad accounts; optimizing ROAS/CPA.

How do I install Paid Ads in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill paid-ads -a claude-code`. Or copy the skill folder (marketing/paid-ads in borghei/Claude-Skills) into .claude/skills/paid-ads in your project. Claude Code loads it when a task matches its description.

How do I install Paid Ads in Codex?

Run `npx skills add borghei/Claude-Skills --skill paid-ads -a codex`. Or copy the skill folder (marketing/paid-ads in borghei/Claude-Skills) into .agents/skills/paid-ads in your project. Codex loads it when a task matches its description.

Can I use Paid Ads in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill paid-ads -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paid-ads, .gemini/skills/paid-ads, .github/skills/paid-ads and .opencode/skills/paid-ads in your project.

What does Paid Ads need to run?

Going by SKILL.md and its folder, Paid Ads needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Paid Ads access the network?

SKILL.md names 3 domains. As links in the text: support.google.com, facebook.com and developers.facebook.com. This is read from the text; nothing was executed.

Is Paid Ads safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Paid Ads use?

Paid Ads is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Paid Ads use?

About 6.9k tokens (SKILL.md is roughly 27k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Paid Ads?

Skills that share tags, products or a category with Paid Ads: Ads (Cesarjoquin/Marketing-Skills, 202 stars), Ads (coreyhaines31/marketingskills, 54k stars), Money Ads (iamzifei/show-me-the-money, 1k stars) and Mena Ads (growthack88/growth-marketing-os, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paid Ads?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 891 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.