Guide · Agent skill
How to use the TikTok Ads Audit agent skill (ads-tiktok)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The ads-tiktok skill is a set of instructions that lets an AI agent, such as Claude, review a TikTok Ads account and return a structured audit. It is built for marketers and media buyers who want a second opinion, analysts working from exports or screenshots, and teams new to TikTok Ads who need a checklist of measurement and creative gaps. After this guide you will know what the skill does, how to install it, how to ask for an audit, and what to supply so the findings are useful.
TikTok Ads AuditAgriciDaniel/claude-ads · MIT Download the skill Quick start
- 1Download the skill. Download the ZIP for skills/ads-tiktok from the page and unzip it so SKILL.md sits in an ads-tiktok folder.
- 2Place the folder. Move the folder to ~/.claude/skills/ for personal use, or to .claude/skills/ inside a project. Alternatively, upload it under Settings → Capabilities → Skills in the Claude apps.
- 3Install the companion files. Make sure the main ads skill and ads/references/tiktok-audit.md are available, either through the claude-ads plugin or a standalone install.
- 4Gather your data. Collect exports, screenshots or manual values, plus the conversion definition, date window, timezone, currency and spend.
- 5Ask in plain language. Request a TikTok Ads audit and name the area you care about, such as Pixel measurement, Smart+ or TikTok Shop campaigns.
- 6Review the findings. Check evidence coverage and missing inputs first, then go through observations, diagnoses and prioritized recommendations.
What is an agent skill, and what does ads-tiktok make the agent do?
An agent skill is a folder containing a SKILL.md file that tells an AI agent how to handle a specific kind of task. When the skill is installed and your request matches its description, the agent follows its procedure.
The ads-tiktok skill covers a TikTok Ads setup: Pixel and measurement, mobile-first creative, audiences, Smart+ and TikTok Shop campaigns, bidding, budgets, pacing, attribution and ad policy. The agent collects the basic context (objective, conversion definition, account and campaign age, geography, date window, timezone, currency, spend and targets), evaluates the setup, and returns structured findings. These cover what is working, what looks wrong, prioritized recommendations and unscored opportunities, along with contradictions, missing inputs and evidence coverage.
The skill is read-only. It drafts recommended changes but does not make them, and it says so when a feature is not eligible or cannot be measured from the data you provide.
Install the ads-tiktok skill
Download the ZIP for skills/ads-tiktok from our page and unzip it. The skill is a folder with a SKILL.md file inside. Choose one of these locations:
You can put it in your personal skills folder at ~/.claude/skills/ so it is available in all your projects, or in a project's .claude/skills/ folder so it applies only to that project.
In the Claude apps you can instead upload the skill under Settings → Capabilities → Skills.
- Personal: ~/.claude/skills/ads-tiktok/
- Project: .claude/skills/ads-tiktok/ inside your project folder
- Claude apps: Settings → Capabilities → Skills, then upload
Install the required companion files
The skill depends on the main ads skill and its references. Its procedure reads ads/references/tiktok-audit.md and the shared measurement, benchmark, creative, automation, policy and scoring references. The source says these come either with the claude-ads plugin or from a standalone install. The procedure resolves the file from the plugin root (the directory that holds ads/ and skills/) or from the skills directory in a standalone install.
If the references are missing, the audit cannot follow its full procedure, so check that ads/ sits alongside skills/ when you use the plugin layout.
Trigger the skill with natural requests
You do not need a special command. Describe what you want in plain language, and mention TikTok so the agent matches the skill. The skill's description lists these triggers: TikTok Ads, TikTok Pixel, Smart+, TikTok Shop Ads, GMV Max, and Spark Ads.
Give the agent your data in the same message or attach it. Account data can be exports, screenshots or API results, or values you type in by hand.
- Audit my TikTok Ads account. Here is the Pixel event list and a campaign export from the last 30 days.
- Review my TikTok Shop Ads and GMV Max campaigns for measurement gaps. I will paste the numbers.
- Check my Spark Ads creative for mobile-first problems. Screenshots attached.
- Which of my Smart+ settings look wrong? Here is the campaign summary.
Prepare the inputs for a useful audit
The procedure asks for the objective, the conversion definition, account and campaign age, geography, date window, timezone, currency, spend, targets and the data sources you have. Findings are only as good as these inputs, so include them up front. The agent keeps a trail from each finding back to the export, screenshot or value it came from.
If something is missing, the agent should list it under missing inputs rather than guess. Features that are optional, beta, premium, unavailable or ineligible are kept unscored.
- Conversion definition and the event you optimize for
- Date window, timezone and currency
- Spend and any targets you are working toward
- Pixel or event data, campaign exports, or screenshots
Read and use the output
Results come back as structured findings. Read the platform health and evidence coverage first to see how much of the account could be checked. Then review observations and diagnoses, which describe the current state, followed by prioritized recommendations.
Recommendations are drafts. The skill does not apply them. To change campaigns, the source points you to the ads-optimize skill, and for server-side event setup it points to ads-server-side-tracking.
- Observations: what the data shows
- Diagnoses: likely causes, with any uncertainty marked
- Recommendations: prioritized draft changes
- Unscored opportunities: ideas the skill does not rate
- Contradictions and missing inputs: what to check or supply next
What people use it for
- A media buyer asks for a structured second opinion on a TikTok Ads account before a quarterly review.
- An analyst prepares an audit from campaign exports and Pixel event lists without direct platform access.
- A team new to TikTok Ads uses the findings as a checklist of measurement and creative gaps.
- An operator reviews TikTok Shop and GMV Max campaigns for commerce-specific setup issues.
- A marketer checks Spark Ads creative against mobile-first guidance using screenshots.
Frequently asked questions
Is the ads-tiktok skill free?
The source lists the licence as MIT. Check the repository's licence file for the full terms before you use or redistribute it.
Does the skill change my TikTok campaigns?
No. It is explicitly read-only. It drafts recommended changes but does not make them. For changes, the source points to the ads-optimize skill.
Does it need internet access or run scripts?
According to the source, the skill runs no scripts and uses no network. It works from the data you provide, such as exports, screenshots or API results.
What do I need to install before using it?
You need the main ads skill and its references, including ads/references/tiktok-audit.md. These come with the claude-ads plugin or a standalone install, and you must supply your own account data.
Can it set up server-side tracking for me?
No. Server-side event setup is handled by the separate ads-server-side-tracking skill, which the source names for that purpose.
Will it give me fixed bid or pause thresholds?
No. The skill avoids universal rules such as fixed pause or bid thresholds, because benchmarks depend on context like objective, geography and account maturity.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use ads-tiktok if you want a structured, read-only checklist of measurement, creative and campaign gaps in a TikTok Ads account, especially when you can supply exports or screenshots. Pick something else if you need the agent to make live changes, want fixed numeric rules, or need server-side tracking built, since those are handled by ads-optimize, a different approach to benchmarks, or ads-server-side-tracking.
Download the skill