Communitygithub.com

mardab96/tiktok-ads-claude-skills

Audits a TikTok Smart+ campaign by mapping what Smart+ automates against what the media buyer still controls (creative supply, audience exclusions, conversion event, budget, bidding), then ranks the risks. Use when someone types "audit our Smart+ campaign", "what does Smart+ actually control", "Smart+ vs manual", "Smart+ spend is up but results are flat", or "can we trust Smart+ with this budget".

O que é tiktok-ads-claude-skills?

tiktok-ads-claude-skills is a Claude Code agent skill that audits a TikTok Smart+ campaign by mapping what Smart+ automates against what the media buyer still controls (creative supply, audience exclusions, conversion event, budget, bidding), then ranks the risks. Use when someone types "audit our Smart+ campaign", "what does Smart+ actually control", "Smart+ vs manual", "Smart+ spend is up but results are flat", or "can we trust Smart+ with this budget".

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mardab96/tiktok-ads-claude-skills/tree/HEAD/smart-plus-audit-tiktok-ads

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Smart+ Audit

Use this skill when

A Smart+ campaign is live or about to launch and the buyer needs a clear line between what TikTok automates and what still needs a human. Smart+ hides many knobs, so an audit starts from what is visible in screenshots and reporting, not from what the automation is assumed to do.

Common requests:

  • "Audit our Smart+ Web campaign before we move more budget into it."
  • "What does Smart+ decide, and what is still on us?"
  • "Smart+ is spending but CPA is flat. Where do we look?"
  • "Client asks if Smart+ beats our manual setup."
  • "Which inputs should we feed Smart+ so it does not drift?"

Do not use this skill for these jobs:

  • Tracking health or missing events: run pixel-events-api-check-tiktok-ads first.
  • One ad losing steam: creative-fatigue-detector-tiktok-ads.
  • Where impressions landed: placement-review-tiktok-ads.
  • TikTok Shop GMV Max profit: gmv-max-profit-check-tiktok-ads.
  • Unfamiliar account with no map: account-triage-tiktok-ads.

Required input

Work from pasted exports and screenshots. Claude's TikTok for Business MCP connector may supply the same tables, but this skill never requires it.

Required

  • Screenshots of the Smart+ setup or edit pages: objective, destination, optimization goal, bidding and optimization, budget, audience (location, language, exclusions), creative section including any AI creative toggles, catalog section if present, placement text.
  • Results export at campaign and ad level with these columns where available: date, campaign, ad group, ad, spend, impressions, clicks, CTR, CPM, reported conversions, CPA, conversion value, frequency.
  • Primary event name and what it counts, plus an Events Manager capture (overview and diagnostics).
  • Dated change log.
  • Goal, target CPA or value target, currency, timezone, attribution setting, conversion lag.

Optional

  • A comparable manual campaign export for the same dates.
  • Result of any split test the buyer ran.
  • Asset list with source per asset (UGC, brand studio, Spark, AI generated).
  • Independent order or lead report for the same dates.

Export route: campaign table or Reporting for the tables, screenshots for settings pages. See ../tiktok-ads-shared/references/getting-your-data.md. Label names move between accounts, so write "as labelled in your Ads Manager" for any label you could not confirm.

Before analysis

  1. Confirm the campaign is Smart+ from a screenshot of the Smart+ toggle or the campaign type label. Record the flavor shown (Web, App, Lead Generation, Traffic, Catalog).
  2. Confirm the primary event and optimization goal. No event definition means needs_data and no performance claim.
  3. Fix two comparable mature windows after the conversion lag (see T04 for the floor of 10 reported conversions per window).
  4. Read the change log for edits inside the first learning window. If edits stack up, run learning-phase-guard-tiktok-ads before judging results (T05).
  5. Note features that depend on market or advertiser, such as gender targeting, multilingual tooling, and some placements. Treat them as "as labelled in your Ads Manager".

Analysis workflow

  1. Inventory every visible setting and tag it screenshot. Anything not visible is needs_data, never assumed.
  2. Fill the boundary map in Decision rules, one row per input, naming the manual owner.
  3. Audit creative supply: asset count, format mix, source mix, age, Spark versus non-Spark mix, and which ads actually received spend. Smart+ can shift budget and pause weak creatives itself, so uneven spend is expected and is not proof of quality.
  4. Audit exclusions: audience exclusions applied (existing customers, converters, employees where relevant), geography and language scope, catalog scope if any.
  5. Audit the event: does the optimization goal match the business outcome, is value passed when value optimization is used, and do diagnostics show a T10 pattern.
  6. Audit budget and bidding against the strategy label shown on screen. Route label questions to bid-strategy-check-tiktok-ads and budget moves to budget-scaling-planner-tiktok-ads.
  7. Read delivery outcomes: spend share by ad, CPA by ad on mature rows, trend against the manual comparison if supplied. Flag reporting you cannot split (for example placement or audience detail that the campaign type does not expose).
  8. Write the review cadence and the approval queue. Live changes stop at approval_needed.

Decision rules

Boundary map

InputWhat Smart+ automates (per TikTok help pages)What stays with the buyerAudit check
Campaign and audience targetingTargeting and audience expansion inside the limits you setLocation, language, gender where offered, audience exclusionsExclusions present, scope matches the market served
OptimizationDelivery optimization toward the chosen goalChoice of optimization goal and primary eventEvent matches business outcome, diagnostics clean (T10)
Creative combinationsCombines assets, CTAs, and format variations, detects ad group fatigue, auto-refreshesSupply of source assets, claims, brand rules, music and licensingCount, variety, age, claim approval, AI creative toggles
Budget between creativesMay shift budget to stronger creatives and pause weak onesCampaign budget and scheduleSpend share by ad, no manual pause fights
PlacementsAutomatic selection in Smart+ Web as documented in March 2026Choosing a non-Smart+ campaign if exact placement control is requiredPlacement report if the account exposes one
BiddingDelivers inside the strategy you pickStrategy label, target value, budget levelLabel confirmed by screenshot, learning state (T05)
Paid and organic linkMay add an organic anchor link to select postsWhether organic posts are brand safe and on offerCheck posts that carry the link
MeasurementNothing automatedPixel, Events API, attribution setting, split test designT10, T07, test hygiene

Verdicts

ConditionVerdictNext step
Primary event falls at least 30% while clicks stay within 10% of baseline over comparable seven-day windows (T10)hold on every optimization claimRun pixel-events-api-check-tiktok-ads
Campaign or ad group still learning-sensitive: under about 25 results or 7 days since entry (T05)hold on edits, monitor on resultsRun learning-phase-guard-tiktok-ads
CPA at least 30% above baseline with at least 10 conversions per window (T04)likely problem, cause unknownRun cpa-spike-diagnosis-tiktok-ads
One ad holds a clear majority of spend and its CTR is sliding (T01 floors apply)possible supply problemRun creative-fatigue-detector-tiktok-ads, plan new assets
Creative supply visibly thin: few assets, one source, one formatlikely risk, approval_needed for new assetsHand to ugc-brief-writer-tiktok-ads
Exclusions missing for existing customers or convertersconfirmed gap if the screenshot shows noneapproval_needed to add exclusions
Results look good, no controlled comparison existspossible Smart+ benefit onlyDesign a split test, claim nothing yet
Settings or event screenshots missingneeds_dataAsk for the exact screen

Confidence rule: confirmed applies only to what a screenshot or export shows. Statements about how the automation works are hypothesis unless a TikTok page is cited with its date.

Output format

Fill this template. Keep it to one page for the buyer plus the table.

## Smart+ audit: [campaign], [dates], [currency], [timezone]
Goal: [target]. Primary event: [name]. Lag: [days]. Attribution: [setting].
Smart+ flavor seen in screenshot: [Web | App | Lead Gen | Traffic | Catalog | needs_data]

### Boundary map
| Input | Automation shown | Manual owner | Evidence | Risk | Next review |
|---|---|---|---|---|---|

### Findings
| Finding | Evidence | Verdict | Severity | Confidence | Business impact | Next step |
|---|---|---|---|---|---|---|

### Creative supply snapshot
Assets: [n] | Formats: [list] | Sources: [list] | Spark mix: [yes/no] | Spend share top ad: [%]

### Review cadence
[who checks what, on which date, after the lag]

### Approval queue
[each live change with named approver, nothing applied]

### Data gaps
[missing screen or export, and the verdict it would firm up]

Practical example

Illustrative numbers only. A Smart+ Web campaign for a home-fitness brand, target CPA 40 USD, 7 days of conversion lag, 28 days of data.

Screenshots show the Conversion goal on a Purchase event, a budget set, location and language chosen, no audience exclusion, and five video assets from one UGC creator. One ad has 61% of spend, while CTR slid from 1.1% to 0.8% across two mature weeks. Reported CPA sits at 44 USD, above target but under the T04 trigger.

Findings: the event is confirmed as Purchase (screenshot). An exclusion gap is confirmed, medium severity, spend impact. Thin creative supply from a single source is likely, medium, conversion impact. A top-ad slide is possible fatigue, because frequency was not exported and the T01 pairing cannot be checked. Whether Smart+ beats the old manual campaign is possible at best, since the manual campaign ran a different event and budget.

Approval queue: add a customer exclusion, brief three new assets from other creators, export frequency for T01, and run a split test with matched event and budget before anyone reports lift.

Common failure modes

  • Crediting Smart+ for results the Pixel or Events API reports. A tracking change moves reported conversions with no delivery change.
  • Reading ad-level CPA as creative quality when Smart+ itself reallocated budget and paused ads.
  • Comparing Smart+ with a manual campaign that has a different event, budget, or date range.
  • Assuming "automated audience" means exclusions are unnecessary.
  • Assuming placement control exists inside Smart+ Web. TikTok's March 2026 page says manual placement selection is not supported there.
  • Letting AI generated or auto-refreshed creative carry claims nobody approved. Brand safety and claims are manual decisions.
  • Calling the campaign out of learning because spend is steady. Use T05 and the status on screen.
  • Presenting platform-reported conversions or value as profit.

Route to next

Event problems: pixel-events-api-check-tiktok-ads. CPA movement: cpa-spike-diagnosis-tiktok-ads. Edits during learning: learning-phase-guard-tiktok-ads. Strategy label doubts: bid-strategy-check-tiktok-ads. Raising budget: budget-scaling-planner-tiktok-ads. Spark permissions: spark-vs-brand-ad-split-tiktok-ads. Reported versus independent numbers: attribution-gap-check-tiktok-ads.

Guardrails

  • Do not make a live account, budget, bid, placement, tracking, Shop, page, or creative change.
  • Do not mark a setting confirmed unless a screenshot or export shows it.
  • Do not describe how Smart+ works beyond what a dated TikTok help page or the supplied screens state; label the rest hypothesis.
  • Do not present platform-reported conversions or GMV as profit without the supplied cost stack.
  • Do not hide missing dates, lag, attribution settings, or conversion definitions.
  • Do not claim Smart+ lift before a controlled comparison with matched event, budget, and dates exists.
  • Do not read ad-level CPA as creative quality without noting that Smart+ may have shifted budget between ads.

Individual skills in this repo

This repo contains 18 individual skills — each has its own dedicated page.

mardab96/tiktok-ads-claude-skills

Runs an ordered, layer-by-layer triage of an unfamiliar TikTok Ads account (tracking, structure, learning, creative, bidding, landing page) and hands the first blocker to one named sibling skill. Use when the user inherits a TikTok account, onboards a client, asks where to start, says TikTok results dropped with no known cause, asks whether an account is ready to scale, or says "audit this TikTok account" without naming a problem.

mardab96/tiktok-ads-claude-skills

Reconciles TikTok Ads Manager conversions with GA4, Shopify, CRM, or app analytics using a baseline-ratio method, separating click-through from view-through credit, attribution window and timezone differences, and real tracking drift (T07). Use when a TikTok media buyer or client says "TikTok says 200 sales, Shopify says 90", "GA4 does not show our TikTok conversions", "TikTok ROAS looks too good", "the gap got bigger this month", or "which number do we report to the client".

mardab96/tiktok-ads-claude-skills

Checks whether a TikTok ad group's bidding strategy fits its goal, budget, and conversion volume using the labels TikTok currently lists (Maximum Results, Target Cost per Result, value options as shown in the account) and asks for a screenshot before mapping any legacy name. Use when someone types "Maximum Results or Target Cost per Result", "Cost Cap vs Lowest Cost on TikTok", "our target CPA is too low and delivery died", "bid strategy check", or "should we use hybrid bidding".

mardab96/tiktok-ads-claude-skills

Builds a staged TikTok budget plan with entry gates, one change per observation window, stop rules, and a recorded rollback, using T04, T05, T06, and T10 from the shared register. Use when someone types "can we scale this TikTok campaign", "double the budget on the winner", "how fast can I raise the daily budget", "scale before the sale", or "plan the budget increase for next week".

mardab96/tiktok-ads-claude-skills

Strips personal data from TikTok ad comments, clusters them into objections, questions, proof requests, and noise with counts, links each cluster to product facts, and drafts reply options and hook ideas for approval. Use when the user pastes TikTok comments and asks "what are people objecting to", "mine the comments for hooks", "draft replies to these comments", "what do viewers keep asking", or wants an FAQ and creative briefs built from comment themes.

mardab96/tiktok-ads-claude-skills

Diagnoses a TikTok CPA jump by splitting it into CPM, CTR, and CVR movement between a baseline and a current window with the cpa_decompose.py helper, then checking tracking, changes, mix, creative, and landing page in that order. Use when someone types "TikTok CPA doubled", "cost per purchase is up 40%", "why did CPA spike", "CVR dropped but clicks are fine", or "the client wants to know what broke".

mardab96/tiktok-ads-claude-skills

Detects whether a TikTok ad is tiring by comparing the last seven distinct dates with the preceding seven for frequency and CTR, using the bundled fatigue_scan.py script and a 14-date rule, then builds a control-versus-refresh queue. Use when the user asks "is this TikTok ad fatigued", says CTR is dropping while frequency climbs, wants to know when to refresh TikTok creative, or pastes a daily ad export and asks which ads to replace.

mardab96/tiktok-ads-claude-skills

Turns TikTok Shop and GMV Max reporting into a per-product cost-stack ledger with refunds, affiliate commissions, seller-funded coupons, referral fees, ad spend, COGS, and seller-borne shipping, using gmv_profit.py to flag any incomplete cost stack (T09). Use when a TikTok Shop seller or media buyer says "GMV Max ROI looks great but we are not making money", "is this product profitable on TikTok Shop", "check our TikTok Shop margins", "affiliate commissions are eating us", or before raising a GMV Max budget or ROI target.

mardab96/tiktok-ads-claude-skills

Scores the opening seconds of TikTok ads by computing 2-second and 6-second view rates and a thumb-stop proxy from ad-level export columns, comparing them with like-for-like ads, and scoring the script opening on a five-point rubric. Use when the user asks "which TikTok hook is weak", "what's my hook rate", "why do people scroll past my ad", wants a hook test plan, or pastes a transcript of the first seconds next to video-view columns.

mardab96/tiktok-ads-claude-skills

Sequences planned TikTok edits around the learning phase, separating urgent repairs from optimisation, naming which edits TikTok itself labels as affecting learning, and ordering one observable action at a time with rollback. Use when someone types "can I edit this ad group during learning", "will this reset the learning phase", "campaign is in learning, what can we change", "sequence these changes", or "the client wants five edits this week".

mardab96/tiktok-ads-claude-skills

Checks TikTok Pixel and Events API health from Events Manager screenshots and an Ads Manager export, covering event match signals, event_id deduplication between browser and server events, parameter completeness on value events, and primary-event drops against stable clicks (T10). Use when a TikTok media buyer says "purchases dropped but clicks are flat", "check our TikTok pixel", "is Events API deduplicating", "Events Manager shows a diagnostic warning", "TikTok value does not match our orders", or before any bid, budget, or scale call that depends on TikTok conversion data.

mardab96/tiktok-ads-claude-skills

Reviews TikTok Ads delivery split between the TikTok placement and Pangle or TikTok Ad Network inventory (as labelled in your Ads Manager), testing CPA and downstream quality per placement against T08 and keeping brand safety and suitability as a separate question. Use when a TikTok media buyer says "should we turn off Pangle", "where is our TikTok spend actually going", "automatic placement is eating budget", "network traffic converts badly", "is our TikTok ad showing next to unsafe content", or when a client asks for a placement and brand safety readout.

mardab96/tiktok-ads-claude-skills

Reviews TikTok Search Ads search terms and keywords and decides what to add as a keyword, add as a negative, or watch, with match handling as labelled in the account and a lag-aware waste floor. Use when someone types "review our TikTok search terms", "negative keyword list for TikTok Search Ads", "which queries should become keywords", "broad match is bringing junk", or "Search Ads spend with zero conversions".

mardab96/tiktok-ads-claude-skills

Compares TikTok Spark Ads with brand-handle ads like-for-like by matching objective, optimization event, audience, offer, placements, bidding label, dates, and concept before any metric is read, then records authorization status and designs a matched test when no clean pair exists. Use when the user asks "do Spark ads perform better than our brand ads", "Spark vs non-Spark", "should we boost creator posts", "why is the creator ad cheaper", or pastes ad-level data with a format column and wants a verdict.

mardab96/tiktok-ads-claude-skills

Writes a complete creator-facing UGC brief for TikTok ads, with viewer situation, one message, three hook options, scene structure, claims allowed and forbidden, do and don't lists, disclosure, usage rights, and a Spark authorization note, plus an internal approval checklist. Use when the user says "write a UGC brief for TikTok", "brief a creator", "I need a creator script with approved claims", "what rights do I need to run this creator video as an ad", or has product facts and needs something a creator can film from.

mardab96/tiktok-ads-claude-skills

Finds mature TikTok campaigns, ad groups, and ads that spent past a CPA-based floor with zero reported conversions, after excluding rows still inside the conversion lag, using the wasted_spend.py helper. Use when someone types "where is the wasted spend on TikTok", "which ad groups burn budget with no conversions", "what can we cut before we scale", "zero conversion ads", or "clean this account before the client call".

mardab96/tiktok-ads-claude-skills

Writes the weekly TikTok Ads client report as a plain-language narrative, a scorecard against the client goal, and next-week decisions with owners and approvals, after an integrity check on tracking, lag, and learning status (T04, T05, T07, T10). Use when an agency or freelance TikTok media buyer says "write the weekly TikTok report", "client update is due", "explain this week's TikTok results to the client", "what do we tell the client about CPA going up", or "set up a repeatable TikTok report format".

mardab96/tiktok-ads-claude-skills

Turns one proven TikTok ad into N distinct angle scripts, each with hook, body beats, CTA, on-screen text, and a shot list, after deconstructing why the winner worked and checking every claim against product facts and rights. Use when the user says "remix my winning TikTok ad", "give me new angles on this winner", "I need five scripts like this one", "my best ad is wearing out, what next", or pastes a winning transcript and asks for variations.

Habilidades Relacionadas