Skip to content
Back to search

ai-ads-claude

SkillWorks with Claude CodeGitHub

AI-powered advertising strategy engine for Claude Code. Build complete ad strategies, generate platform-specific copy (Google, Meta, LinkedIn, TikTok, YouTube, Pinterest), design campaign funnels, allocate budgets, and produce professional PDF reports. 15 skills, 5 parallel agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zubair-trabzada--ai-ads-claude/badge.svg)](/listings/zubair-trabzada--ai-ads-claude)

HTML

<a href="/listings/zubair-trabzada--ai-ads-claude"><img src="/api/listings/zubair-trabzada--ai-ads-claude/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-ads-claude/main/install.sh | bash

That's it. One command installs all 15 skills, 5 agents, and the PDF generation scripts.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 323 lines · 3 findings marked
  1. <p align="center">
  2. <img src=".github/banner.svg" alt="AI Ads Strategist for Claude Code" width="900"/>
  3. </p>
  4. <p align="center">
  5. <strong>AI Ads Strategist for Claude Code.</strong> Build complete ad strategies, generate platform-specific copy,<br/>
  6. design campaign funnels, allocate budgets, and produce client-ready PDF reports — 15 skills, 5 parallel agents, 6 platforms.
  7. </p>
  8. <p align="center">
  9. <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"/></a>
  10. <img src="https://img.shields.io/badge/Skills-15-blue" alt="15 Skills"/>
  11. <img src="https://img.shields.io/badge/Agents-5-orange" alt="5 Agents"/>
  12. <img src="https://img.shields.io/badge/Platforms-6-green" alt="6 Platforms"/>
  13. <img src="https://img.shields.io/badge/Python-3.8+-blue" alt="Python 3.8+"/>
  14. <img src="https://img.shields.io/badge/PDF-Reports-red" alt="PDF Reports"/>
  15. </p>
  16. ---
  17. ## Quick Start
  18. ```bash
  19. curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-ads-claude/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 24 on GitHub
  20. ```
  21. That's it. One command installs all 15 skills, 5 agents, and the PDF generation scripts.
  22. ---
  23. ## What Is This?
  24. AI Ads Strategist is a complete advertising strategy engine built as Claude Code skills. It turns a single URL into a full ad strategy — audience personas, platform-specific copy, campaign funnels, budget allocation, competitive intelligence, and a professional PDF report.
  25. Run `/ads strategy <url>` and 5 AI agents launch in parallel to analyze your business and produce a complete advertising playbook.
  26. No ad platform login required. No API keys. Just Claude Code.
  27. ---
  28. ## Architecture
  29. ```
  30. /ads strategy <url>
  31. |
  32. ┌─────────────┼─────────────┐
  33. | | |
  34. ┌─────┴─────┐ ┌────┴────┐ ┌──────┴──────┐
  35. | ads-audience| |ads-funnel| |ads-creative |
  36. | agent | | agent | | agent |
  37. | (personas, | | (TOFU/ | | (copy, |
  38. | targeting)| | MOFU/ | | hooks, |
  39. | | | BOFU) | | video) |
  40. └────────────┘ └─────────┘ └─────────────┘
  41. | | |
  42. ┌─────┴──────┐ ┌───┴─────┐
  43. |ads-competitive| |ads-budget|
  44. | agent | | agent |
  45. | (competitor | | (alloc, |
  46. | gaps, ads) | | ROI) |
  47. └──────────────┘ └─────────┘
  48. | | |
  49. └─────────────┼─────────────┘
  50. |
  51. ┌─────────────┴─────────────┐
  52. | Composite Ad Readiness |
  53. | Score (0-100) + Grade |
  54. | + PDF Strategy Report |
  55. └───────────────────────────┘
  56. ```
  57. ---
  58. ## All 15 Commands
  59. ### Strategy & Analysis
  60. | Command | What It Does |
  61. |---------|-------------|
  62. | `/ads strategy <url>` | **Flagship** — Full ad strategy with 5 parallel agents. Returns Ad Readiness Score (0-100), audience personas, campaign structure, ad copy, budget allocation, and prioritized action plan. |
  63. | `/ads quick <url>` | 60-second ad readiness snapshot — value proposition, offer strength, CTA quality, platform recommendation. |
  64. | `/ads audience <url>` | Build detailed audience personas with demographics, psychographics, platform preferences, and targeting parameters. |
  65. | `/ads competitors <url>` | Competitive ad intelligence — what competitors are running, where they spend, gaps to exploit. |
  66. | `/ads keywords <url>` | Google Ads keyword strategy — search intent mapping, negative keywords, match types, bid recommendations. |
  67. | `/ads audit` | Audit existing ad performance — identify wasted spend, underperforming campaigns, optimization opportunities. |
  68. ### Creative & Copy
  69. | Command | What It Does |
  70. |---------|-------------|
  71. | `/ads copy <platform>` | Generate platform-specific ad copy — headlines, primary text, descriptions, CTAs for any platform. |
  72. | `/ads hooks` | Generate 20 scroll-stopping hooks — pattern interrupts, curiosity gaps, bold claims for social ads. |
  73. | `/ads creative <product>` | Creative briefs for designers and editors — visual direction, format specs, brand guidelines. |
  74. | `/ads video <product>` | Video ad scripts in 15s, 30s, and 60s formats — hook, body, CTA with shot-by-shot direction. |
  75. ### Funnel & Budget
  76. | Command | What It Does |
  77. |---------|-------------|
  78. | `/ads funnel <url>` | Full ads funnel architecture — TOFU/MOFU/BOFU/Retargeting with ad types, audiences, and KPIs per stage. |
  79. | `/ads budget <amount>` | Budget allocation across platforms — percentage splits, monthly amounts, projected CPM/CPC/CPA/ROAS. |
  80. | `/ads testing <campaign>` | A/B testing plan — variables to test, sample sizes, duration, success criteria, statistical significance. |
  81. | `/ads landing <url>` | Landing page audit — conversion blockers, CTA analysis, trust signals, rewrite recommendations. |
  82. ### Reporting
  83. | Command | What It Does |
  84. |---------|-------------|
  85. | `/ads report-pdf` | Professional 6-page PDF strategy report — score dashboard, personas, funnel, ad copy, budget projections. |
  86. ---
  87. ## Supported Platforms
  88. | Platform | Ad Types | Best For |
  89. |----------|----------|----------|
  90. | **Google Ads** | Search, Display, Shopping, YouTube | High-intent search, product listings, retargeting |
  91. | **Meta (Facebook/Instagram)** | Feed, Story, Reels, Carousel, Lead Forms | B2C, e-commerce, local businesses, lookalike audiences |
  92. | **LinkedIn** | Sponsored Content, InMail, Text Ads | B2B, SaaS, professional services, recruiting |
  93. | **TikTok** | In-Feed, TopView, Spark Ads, Branded Effects | Gen Z/Millennial, e-commerce, creators, viral content |
  94. | **YouTube** | Pre-Roll, Mid-Roll, Bumper, Discovery | Brand awareness, product demos, tutorials, retargeting |
  95. | **Pinterest** | Standard Pin, Video Pin, Shopping, Carousel | E-commerce, lifestyle, home, fashion, food, DIY |
  96. ---
  97. ## Scoring Methodology
  98. The **Ad Readiness Score** (0-100) is a weighted composite of 5 dimensions:
  99. | Category | Weight | What It Measures |
  100. |----------|--------|------------------|
  101. | Audience Clarity | 25% | ICP definition, persona depth, targeting precision |
  102. | Creative Quality | 20% | Hook strength, copy quality, visual concepts, video scripts |
  103. | Funnel Architecture | 20% | Campaign structure, stages, retargeting, conversion path |
  104. | Competitive Position | 15% | Differentiation, competitor gaps, market opportunity |
  105. | Budget Efficiency | 20% | Allocation strategy, platform mix, projected CPM/CPC/CPA |
  106. ### Grade Interpretation
  107. | Grade | Score | Meaning |
  108. |-------|-------|---------|
  109. | **A+** | 95-100 | Elite — campaign-ready, launch immediately |
  110. | **A** | 90-94 | Excellent — minor optimizations before launch |
  111. | **A-** | 85-89 | Very strong — refine targeting or creative |
  112. | **B+** | 80-84 | Good — solid foundation, needs polish |
  113. | **B** | 75-79 | Above average — some gaps to address |
  114. | **B-** | 70-74 | Decent — noticeable improvements needed |
  115. | **C+** | 65-69 | Fair — multiple areas need attention |
  116. | **C** | 60-64 | Below average — significant work required |
  117. | **C-** | 55-59 | Weak — major gaps in strategy |
  118. | **D+** | 50-54 | Poor — fundamental issues across categories |
  119. | **D** | 45-49 | Very poor — strategy overhaul recommended |
  120. | **D-** | 40-44 | Critical — not ready for paid advertising |
  121. | **F** | 0-39 | Failing — build foundations before spending on ads |
  122. ---
  123. ## Sample Output
  124. ### `/ads strategy`
  125. ```
  126. ╔══════════════════════════════════════════════════════════════╗
  127. ║ AI ADS STRATEGY REPORT ║
  128. ║ Acme Growth Co. — acmegrowth.com ║
  129. ╚══════════════════════════════════════════════════════════════╝
  130. AD READINESS SCORE: 67/100 (Grade: C+)
  131. ┌──────────────────────┬───────┬────────┬──────────┐
  132. │ Category │ Score │ Weight │ Status │
  133. ├──────────────────────┼───────┼────────┼──────────┤
  134. │ Audience Clarity │ 72 │ 25% │ Needs Work│
  135. │ Creative Quality │ 65 │ 20% │ Needs Work│
  136. │ Funnel Architecture │ 58 │ 20% │ Needs Work│
  137. │ Competitive Position │ 70 │ 15% │ Needs Work│
  138. │ Budget Efficiency │ 62 │ 20% │ Needs Work│
  139. └──────────────────────┴───────┴────────┴──────────┘
  140. TOP 3 QUICK WINS:
  141. 1. Add retargeting campaign for website visitors (missing BOFU)
  142. 2. Replace generic CTAs with benefit-driven copy
  143. 3. Create Meta Lookalike audience from customer email list
  144. Saved: ADS-STRATEGY-AcmeGrowth.md
  145. ```
  146. ### `/ads quick`
  147. ```
  148. ⚡ AD READINESS SNAPSHOT — acmegrowth.com
  149. Score: 67/100 (C+)
  150. Best Platform to Start: Meta (Facebook/Instagram)
  151. Estimated Starting Budget: $1,500-$3,000/mo
  152. ✓ Clear value proposition
  153. ✓ Product-market fit signals
  154. ✓ Existing social proof (testimonials)
  155. ✗ No retargeting pixel detected
  156. ✗ Landing page CTA is weak ("Learn More")
  157. ✗ No video content for ads
  158. ```
  159. ---
  160. ## Use Cases
  161. ### Agency Owners
  162. Run `/ads strategy` for any prospect to deliver a professional ad strategy audit. Charge $500-$2,000 per audit, or use it as a lead magnet to close retainer deals.
  163. ### E-commerce Brands
  164. Generate platform-specific ad copy for product launches across Meta, Google Shopping, TikTok, and Pinterest. Use `/ads funnel` to design a complete TOFU-to-retargeting campaign architecture.
  165. ### SaaS Companies
  166. Build audience personas for B2B targeting on LinkedIn and Google Search. Use `/ads budget` to allocate spend across platforms and project CAC, LTV, and ROAS.
  167. ### Local Businesses
  168. Get started with the right platform and budget. `/ads quick` identifies whether Google Ads or Meta is better for your service area, and `/ads budget` shows how to allocate a small budget effectively.
  169. ### Freelancers
  170. Add ad strategy to your service offering. Use `/ads report-pdf` to deliver professional PDF reports that justify your rates and demonstrate expertise.
  171. ---
  172. ## Installation
  173. ### Prerequisites
  174. - **Claude Code** (with an active Anthropic API key)
  175. - **Python 3.8+** (for PDF generation only)
  176. - **reportlab** — `pip3 install reportlab` (for PDF generation only)
  177. ### One-Line Install
  178. ```bash
  179. curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-ads-claude/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 238 on GitHub
  180. ```
  181. ### Manual Install
  182. ```bash
  183. git clone https://github.com/zubair-trabzada/ai-ads-claude.git
  184. cd ai-ads-claude
  185. chmod +x install.sh
  186. ./install.sh
  187. ```
  188. ### Uninstall
  189. ```bash
  190. curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/ai-ads-claude/main/uninstall.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 253 on GitHub
  191. ```
  192. Or run locally:
  193. ```bash
  194. ./uninstall.sh
  195. ```
  196. ---
  197. ## Project Structure
  198. ```
  199. ai-ads-claude/
  200. ├── ads/
  201. │ └── SKILL.md # Main orchestrator (command router)
  202. ├── skills/
  203. │ ├── ads-audience/SKILL.md # Audience personas & targeting
  204. │ ├── ads-competitors/SKILL.md # Competitive ad intelligence
  205. │ ├── ads-keywords/SKILL.md # Google Ads keyword strategy
  206. │ ├── ads-copy/SKILL.md # Platform-specific ad copy
  207. │ ├── ads-hooks/SKILL.md # Scroll-stopping hooks
  208. │ ├── ads-creative/SKILL.md # Creative briefs
  209. │ ├── ads-video/SKILL.md # Video ad scripts
  210. │ ├── ads-funnel/SKILL.md # Funnel architecture
  211. │ ├── ads-budget/SKILL.md # Budget allocation & ROI
  212. │ ├── ads-testing/SKILL.md # A/B testing plans
  213. │ ├── ads-landing/SKILL.md # Landing page audit
  214. │ ├── ads-audit/SKILL.md # Ad performance audit
  215. │ ├── ads-report-pdf/SKILL.md # PDF report generator
  216. │ └── ads-quick/SKILL.md # 60-second snapshot
  217. ├── agents/
  218. │ ├── ads-audience.md # Audience research agent
  219. │ ├── ads-creative.md # Creative & copy agent
  220. │ ├── ads-funnel.md # Funnel architecture agent
  221. │ ├── ads-competitive.md # Competitor analysis agent
  222. │ └── ads-budget.md # Budget & ROI agent
  223. ├── scripts/
  224. │ └── generate_ads_pdf.py # PDF generation (ReportLab)
  225. ├── install.sh # One-line installer
  226. ├── uninstall.sh # Clean uninstaller
  227. ├── requirements.txt # Python dependencies
  228. └── README.md
  229. ```
  230. ---
  231. ## Disclaimer
  232. This tool is for educational and informational purposes only. Ad strategy recommendations are based on publicly available data and industry benchmarks. Actual advertising results depend on execution, market conditions, and platform algorithms. This is **not** a substitute for professional advertising management. Always test with small budgets before scaling.
  233. ---
  234. <p align="center">
  235. <strong>Part of the Claude Code Skills Series</strong><br>
  236. <a href="https://github.com/zubair-trabzada/ai-marketing-claude">AI Marketing Suite</a> ·
  237. <a href="https://github.com/zubair-trabzada/ai-sales-team-claude">AI Sales Team</a> ·
  238. <a href="https://github.com/zubair-trabzada/ai-legal-claude">AI Legal Assistant</a> ·
  239. <a href="https://github.com/zubair-trabzada/ai-reputation-claude">AI Reputation Manager</a> ·
  240. <a href="https://github.com/zubair-trabzada/geo-seo-claude">GEO/SEO Optimizer</a> ·
  241. <strong>AI Ads Strategist</strong>
  242. </p>
  243. <p align="center">
  244. <a href="https://skool.com/aiworkshop">Learn How to Sell Claude Code Services to Real Businesses</a>
  245. </p>
  246. <p align="center">
  247. <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"/></a>
  248. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.