Claude Ads (Hainrixz) skill

Claude Ads

The /ads skill audits Meta, Google and TikTok ad accounts by 158 checks and returns a 0 to 100 health score and fixes.

  • 108 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • Connected MCP servers and tokens read ad accounts, and some of them can change campaigns.
  • Publishing through Zernio posts material to social networks on your behalf.
All reasons and checks

hainrixz/claude-ads

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/hainrixz-claude-ads

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Connected MCP servers and tokens read ad accounts, and some of them can change campaigns.
  • Publishing through Zernio posts material to social networks on your behalf.

This is third-party code. Review the repository files before installing.

What it does

The skill turns Claude Code into a reviewer of ad campaigns. `/ads audit` runs three specialists in parallel, one each for Meta, Google and TikTok, and merges their findings into a 0 to 100 score with a prioritized fix list. Data comes from an export, a screenshot or pasted numbers, or from MCP servers and API adapters. `/ads next` keeps the top three fixes, `/ads plan` offers templates for eight industries, `/ads math` computes CPA and ROAS, and `/ads report` builds a client PDF. `/ads publish` sends finished creatives to social networks through Zernio.

Who it is for. Marketers and small-business owners who run Meta, Google and TikTok ads themselves and want an independent account review without an agency.

Good fit when

  • Before launching a budget you must check a Meta account for the pixel, CAPI and learning-phase rules.
  • Google Ads campaigns spend budget but bring fewer leads than expected.
  • An agency delivered a report and a second opinion against one checklist is needed.
  • A client PDF with an account health score and a fix list is being prepared.

Not a fit when

  • Ads run in Yandex Direct, VK Ads or LinkedIn: the skill covers only Meta, Google and TikTok.
  • Changes to the account should be applied automatically: the audit produces a list and does not edit campaigns itself.
  • There is neither an export nor API access, so the score would be shallow.

Example request

Run /ads audit on a 30-day Meta export, then /ads next and show the top three fixes.

Limitations

The skill analyzes the data you pass and does not log in to accounts until MCP servers or the adapters from `scripts/api/` are connected. Live mode of some MCP servers can write to the account, so start with read access and a test account. Google Ads needs developer-token approval, which takes one to three business days. `/ads publish` needs a Zernio key, and two connected accounts are free. `/ads update` spends 50 to 150 thousand tokens per platform and asks for confirmation.

How to disable. Remove the plugin through the `/plugin` menu or run `uninstall.sh` from the README if you used `install.sh`. Delete the profile and audit history in `~/.claude-ads/` by hand.

FAQ

Does it need ad account access?

No. The skill reads an export, a screenshot or pasted numbers. Live reading is connected through MCP or `scripts/api/`, and the `/ads start` wizard walks you through it.

What does the health score show?

A number from 0 to 100 combines check results by severity weight. A fix list comes with it, and `/ads next` keeps the top three.

What is paid?

The audit is free. Publishing through Zernio costs money after two accounts, and some commercial MCP servers are optional extras.

Which platforms does the audit cover?

Meta, Google and TikTok, with about 80 checks for Google, 50 for Meta and 28 for TikTok.

How do I audit one platform only?

Use `/ads google`, `/ads meta` or `/ads tiktok`: each runs a deep review of its own platform.

Discussion

No questions or reviews yet.

Skills

Marketing skills for Claude Code, Cursor and Codex: SEO audits, ads and competitors, with a paid part for live account data.

SkillBroad access114Repository stars
Official

One MCP server for ad accounts, analytics and CRM: Google Ads, Meta Ads, GA4, TikTok Ads and LinkedIn Ads

MCP serverBroad access60Repository stars
Russian stack

Claude Code skill: collects semantics for VK Ads from real Wordstat via browser, without Direct or paid APIs

SkillExtended access

A Claude Code skill set for auditing sites for AI search: citability, AI crawler access, llms.txt, schema and reports

SkillExtended access11.6KRepository stars
Russian stack

A Claude plugin marketplace for ad accounts: a zero-setup read-only Direct connector plus full MCP servers for Direct, VK Ads, Metrika and Wordstat

PluginBroad access3Repository stars
Official

Adspirer remote MCP server: Google, Meta, LinkedIn, TikTok and Amazon ad campaigns are built and analyzed from a chat.

MCP serverBroad access107Repository stars

README in short

The README promises a free ad audit for the three platforms that hold most advertiser spend. The plugin installs in a minute and the `/ads start` wizard saves business context to a profile. Version 2.5 added `/ads conciencia`, which tracks closed customers for WhatsApp and form campaigns.

README badge

Original SKILL.md

---
name: ads
description: "Free-first paid advertising audit and optimization skill, focused on the 3 platforms where 95% of advertiser spend lives: Meta, Google, TikTok. Guided onboarding (/ads start) saves context once and step-by-step OAuth walkthroughs; continuous coach (/ads next) ranks Quick Wins after each audit. ~158 weighted checks with scoring, parallel agents, industry templates, and AI creative generation."
argument-hint: "start | next | conciencia | audit | google | meta | tiktok | creative | landing | budget | plan <type> | competitor | dna <url> | create | generate | photoshoot | update <platform|all> | publish"
license: MIT
---
<!-- Portions Copyright (c) 2026 Enrique Rocha (@soyenriquerocha) - see LICENSE for original authors · tododeia.com · id er-fd4fa55b -->

# Ads: Free-first Paid Advertising Audit & Optimization

Focused ad account analysis on the 3 base platforms where most ad spend
lives: **Meta, Google, TikTok**. Orchestrates 20 specialized sub-skills and
7 agents (3 audit + 4 creative). First-run users should type **`/ads start`**
— a guided wizard that captures context, walks them through OAuth setup
step-by-step, and persists everything to `~/.claude-ads/profile.json` so no
future command ever re-asks.

## Quick Reference

| Command | What it does |
|---------|-------------|
| `/ads start` | **First-run wizard** — context capture, per-platform OAuth/MCP walkthroughs with live verification, optional Zernio + Meta Developers signup. Re-run as `/ads start edit/status/reset`. |
| `/ads next` | **Continuous coach** — reads recent audit JSON + history, ranks top 3 Quick Wins by impact × ease, optionally walks you through fixing #1. Detects regressions vs your last audit. |
| `/ads conciencia` | **Campaign awareness** — tracks what Claude knows and doesn't know about real business results (closed customers, lead quality) of WhatsApp / form / call campaigns; dated check-ins cross-referenced with platform clicks and messages → real close rate. |
| `/ads audit` | Full multi-platform audit with parallel subagent delegation (3 agents: Meta, Google, TikTok) |
| `/ads google` | Google Ads deep analysis (Search, PMax, includes YouTube video campaigns) |
| `/ads meta` | Meta Ads deep analysis (FB, IG, Advantage+) — MCP-wired to claude.ai Facebook |
| `/ads tiktok` | TikTok Ads deep analysis (Creative, Shop, Smart+, Symphony, GMV Max) |
| `/ads creative` | Cross-platform creative quality audit |
| `/ads landing` | Landing page quality assessment for ad campaigns |
| `/ads budget` | Budget allocation and bidding strategy review |
| `/ads plan <business-type>` | Strategic ad plan with industry templates |
| `/ads competitor` | Competitor ad intelligence analysis |
| `/ads math` | PPC financial calculator (CPA, ROAS, break-even, budget forecasting) |
| `/ads test` | A/B test design (hypothesis, significance, duration, sample size) |
| `/ads report` | PDF audit report generation for client deliverables |
| `/ads dna <url>` | Extract brand DNA from website, outputs `brand-profile.json` |
| `/ads create` | Generate campaign concepts + copy briefs, outputs `campaign-brief.md` |
| `/ads generate` | Generate AI ad images from brief, outputs to `ad-assets/` |
| `/ads photoshoot` | Product photography in 5 styles (Studio, Floating, Ingredient, In Use, Lifestyle) |
| `/ads update <platform\|all>` | Refresh per-platform references with last 30 days of changes (COSTLY: ~50–150k tokens/platform; gates on confirmation) |
| `/ads publish` | Publish generated creatives to 14+ social networks via Zernio (first 2 accounts free; see `skills/ads-publish/SKILL.md`) |

## First-run behavior

Report a problem