ads
Skill190 starsChanged 6 months agoMITView on GitHub
When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,' 'LinkedIn ads,' 'ad budget,' 'cost per click,' 'ad spend,' or 'should I run ads.' Use this for campaign strategy, audience targeting, bidding, and optimization. For bulk ad creative generation and iteration, see ad-creative. For landing page optimization, see cro.
We split this skill into the rules it gives an agent
21 rules. 0 are common, 18 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 44 edited versions we read keep these.
18
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 15
If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older …
- Distinctive: line 34
Do you have existing customer data for lookalikes?
- Distinctive: line 38
Do you have existing pixel/conversion data?
- Distinctive: line 90
Wait 3-5 days between increases for algorithm learning
- Distinctive: line 174
Check landing page (is the problem post-click?)
- Distinctive: line 176
Test new creative angles
- Distinctive: line 191
Start with manual or cost caps
- Distinctive: line 236
Use UTM parameters consistently
- Distinctive: line 238
Look at blended CAC, not just platform CPA
- Distinctive: line 244
Before launching campaigns, ensure proper tracking and account setup.
- Distinctive: line 262
When the user requests Google Ads RSAs (Responsive Search Ads), output MUST comply with these platform limits and structural requirements.
- Very specific: line 281
If .agents/product-marketing.md indicates a Brazilian medical practice (CFM-regulated), the following terms are forbidden in headlines, …
- Very specific: line 287
Use neutral framing: atendimento, consulta, avaliação, segunda opinião, agende sua consulta, tire suas dúvidas.
- Distinctive: line 339
Before sending the output, run this checklist mentally:
- Distinctive: line 347
If any check fails, rewrite before responding.
- Distinctive: line 356
Not giving algorithms enough learning time
- Distinctive: line 361
Not excluding existing customers
- Distinctive: line 365
Only one ad per ad set
- Distinctive: line 366
Not refreshing creative (fatigue)
- Distinctive: line 381
Do you have existing creative assets or need to create them?
- Distinctive: line 383
Do you have pixel/conversion tracking set up?
“Common” is measured: kept by at least 6 in 10 of the 44 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Paid 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 .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), 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:
META_Conv_Lookalike-Customers_FreeTrial_2024Q1
GOOG_Search_Brand_Demo_Ongoing
LI_LeadGen_CMOs-SaaS_Whitepaper_Mar24Budget 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: Exclude existing customers and recent converters — showing ads to people who already bought wastes spend
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
Weekly Review
- Spend vs. budget pacing
- CPA/ROAS vs. targets
- 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
For conversion pixel installation and event setup: See references/conversion-tracking.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
Google RSA Output Spec (mandatory when generating RSAs)
When the user requests Google Ads RSAs (Responsive Search Ads), output MUST comply with these platform limits and structural requirements. Do not output any RSA that violates them.
Hard limits per RSA (enforce before responding)
- Headlines: exactly 15 per RSA, each ≤ 30 characters (count characters, including spaces). Render as
1. ... (NN chars)so the reader can verify. - Descriptions: exactly 4 per RSA, each ≤ 90 characters.
- Paths: up to 2 path fields, each ≤ 15 characters.
- Final URL: present, https.
- Pinning: state any pinned positions explicitly. Default = unpinned unless user asks.
- Per-account guardrail: Google enforces 3 RSAs max per ad group. When the user asks for >3, group them by ad group.
Required sidecar artifacts (always include with RSA request)
- Ad group structure, labeled
Ad group structure:— list each ad group with its theme, target keywords (match types), and which RSAs map to it. - Negative keyword list, labeled
Negative keywords:— minimum 8 entries, group-level vs campaign-level called out. - Sitelinks (≥ 4), Callouts (≥ 4 ≤25 chars), Structured snippets if relevant.
Medical / CFM compliance (when product context indicates pt-BR medical practice)
If .agents/product-marketing.md indicates a Brazilian medical practice (CFM-regulated), the following terms are forbidden in headlines, descriptions, sitelinks, and callouts:
- Superlatives:
#1,melhor,o melhor,melhor do brasil,top,referência - Outcome promises:
garantido,garantia,cura,cura definitiva,100%,resultado garantido,livre da dor - Comparative claims vs other doctors/clinics
Use neutral framing: atendimento, consulta, avaliação, segunda opinião, agende sua consulta, tire suas dúvidas. Geo modifier (Porto Alegre, POA, Zona Sul POA) required where the prompt specifies a region.
Output ORDER (mandatory — emit in this order to avoid truncation)
- Ad group structure (short)
- Negative keywords (≥8, MANDATORY — emit BEFORE RSAs so it isn't dropped if output runs long)
- Sitelinks (≥4)
- Callouts (≥4)
- RSA1, RSA2, RSA3 (largest section, last — safe to truncate gracefully)
Output template (mandatory shape)
Ad group structure:
- AG1 [theme]: keywords (match types) → RSA1, RSA2
- AG2 [theme]: ...
Negative keywords:
Campaign-level:
- <kw>
- <kw>
(≥4 here)
Ad-group level:
- AG1: <kw>, <kw>
- AG2: <kw>, <kw>
(≥4 more here — TOTAL ≥8 entries)
Sitelinks (≥4):
- <title (≤25)> | <desc1 (≤35)> | <desc2 (≤35)> | URL
Callouts (≥4, each ≤25 chars):
- <callout>
RSA1 — [ad group name]
Final URL: https://...
Path1: ... Path2: ...
Headlines (15, each ≤30 chars):
1. <headline> (NN chars)
...
15. <headline> (NN chars)
Descriptions (4, each ≤90 chars):
1. <description> (NN chars)
...
4. <description> (NN chars)
Pinning: H1=none; H2=none; ... (or explicit pins)
RSA2 — ...
RSA3 — ...Self-check before responding
Before sending the output, run this checklist mentally:
- Each RSA has exactly 15 headlines, exactly 4 descriptions.
- Every headline is ≤30 chars; every description is ≤90 chars. Character counts printed.
- Negative keyword list labeled and ≥8 entries.
- Ad group structure labeled.
- If medical (CFM): no forbidden superlative/outcome words; geo modifier present where required; language is pt-BR.
If any check fails, rewrite before responding. Do not ship partial RSAs.
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
For implementation, see the tools registry. Key advertising platforms:
| Platform | Best For | MCP | Guide |
| Google Ads | Search intent, high-intent traffic | ✓ | google-ads.md |
| Meta Ads | Demand gen, visual products, B2C | - | meta-ads.md |
| LinkedIn Ads | B2B, job title targeting | - | linkedin-ads.md |
| TikTok Ads | Younger demographics, video | - | tiktok-ads.md |
For tracking setup, see references/conversion-tracking.md, ga4.md, segment.md
Related Skills
- ad-creative: For generating and iterating ad headlines, descriptions, and creative at scale
- copywriting: For landing page copy that converts ad traffic
- analytics: For proper conversion tracking setup
- ab-testing: For landing page testing to improve ROAS
- cro: For optimizing post-click conversion rates
Other versions50 projects use a version of this.
Word for word · 4
- SZcalligrapher/slash-skills-subscription★ 32100% same
- AayanHetam/chess-coach-ai★ 0100% same
- AbdelrhmanAlquran/claude-skills★ 0100% same
- itaymizzz/claude-skills★ 0100% same
Edited · 21
- coreyhaines31/marketingskills★ 58k31% same
- Yg0rAndrade/carcara-code★ 8434% same
- open-fox/agents★ 5531% same
- TommyBez/skillsboard★ 831% same
- anis-dr/skills★ 333% same
- Shri-Phnx/claude-skills★ 246% same
- agrivisionai/claude-skills★ 131% same
- Big-LAORE/Biblioth-que-de-skills★ 131% same
- ngothanhtung/claude-code-skills★ 131% same
- patinaproject/skills★ 131% same
11 more not listed
Wrote their own version · 25
- AgriciDaniel/claude-ads★ 10ksame name
- zubair-trabzada/ai-ads-claude★ 234same name
- Hainrixz/claude-ads★ 102same name
- PostPlusAI/postplus-skills★ 27same name
- spotify/ads-agentic-tools★ 19same name
- coopersimson96/ai-content-system★ 17same name
- syutolee/digital-marketing-skills-pack★ 10same name
- itsjwill/ad-audit-pro★ 9same name
- scayver/marketing-skills★ 8same name
- marek-kujda/ad-copy-skill-pack★ 4same name
15 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use marketing-council, ads-apple and 2 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
coreyhaines31Skillmarketing-council
When the user wants multiple expert perspectives on a marketing question — a simulated board of advisors staffed by legendary marketers (Seth Godin, David Ogilvy, Eugene Schwartz, April Dunford, Rory Sutherland, Alex Hormozi, Byron Sharp, and more). Also use when the user mentions 'marketing council,' 'board of advisors,' 'advisory board,' 'what would Seth Godin say,' 'what would Ogilvy think,' 'channel Hormozi,' 'get multiple perspectives,' 'debate this,' 'have the council review,' 'marketing mentors,' or asks how a famous marketer would approach their problem. The council gives each advisor's take through their documented frameworks, surfaces where they disagree, and synthesizes a recommendation. For executing the winning direction, hand off to positioning, offers, copywriting, ads, or the relevant skill.
Also in 17 projects that use this
chriswesttSkillads-apple
Apple Ads (formerly Apple Search Ads) deep analysis for mobile app advertisers. Evaluates campaign structure, bid health, Custom Product Pages (CPPs), MMP attribution, budget pacing, TAP coverage (Today/Search/Product Pages), Maximize Conversions bidding, and goal CPA benchmarks by country. Use when user says Apple Ads, Apple Search Ads, ASA, App Store ads, Apple ads, Search Ads, or is advertising a mobile app on iOS.
Also in 4 projects that use this
chriswesttSkillads-dna
Brand DNA extractor for paid advertising. Scans a website URL to extract visual identity, tone of voice, color palette, typography, and imagery style. Outputs brand-profile.json to the current directory. Run before /ads create or /ads generate for brand-consistent creative. Triggers on: brand DNA, brand profile, extract brand, brand identity, brand colors, what is the brand voice, analyze brand, brand style guide.
Also in 4 projects that use this
- +1 more from chriswestt
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ab-testingSkill
- ad-creativeSkill
- ai-seoSkill
- analyticsSkill
- asoSkill
- churn-preventionSkill
- cold-emailSkill
- co-marketingSkill
- community-marketingSkill
- competitor-profilingSkill
- competitorsSkill
- content-strategySkill
- copy-editingSkill
- copywritingSkill
- croSkill
- customer-researchSkill
- directory-submissionsSkill
- emailsSkill
- free-toolsSkill
- imageSkill
- launchSkill
- lead-magnetsSkill
- marketing-ideasSkill
- marketing-planSkill
- marketing-psychologySkill
- offersSkill
- onboardingSkill
- paywallsSkill
- popupsSkill
- pricingSkill
- product-marketingSkill
- programmatic-seoSkill
- prospectingSkill
- public-relationsSkill
- referralsSkill
- revopsSkill
- sales-enablementSkill
- schemaSkill
- seo-auditSkill
- signupSkill
- site-architectureSkill
- smsSkill
- socialSkill
- videoSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

