Skip to content

Guide · Agent skill

How to use the YouTube Ads Audit agent skill (ads-youtube)

Updated · written with AI from the project's own documentation and checked against our catalogue data

The ads-youtube skill is a set of instructions that lets an AI agent audit a YouTube Ads account or campaign setup against a structured checklist. This guide covers what the skill makes the agent do, how to install it, how to ask for an audit, and what to check before you trust the results. You do not need prior experience with agent skills to follow it.

YouTube Ads AuditAgriciDaniel/claude-ads · MIT

Quick start

  1. 1Download the ZIP. Download the ads-youtube ZIP from this page and unzip it. Confirm the folder contains SKILL.md.
  2. 2Choose a location. Place the folder in ~/.claude/skills/ for all projects, or in .claude/skills/ inside one project.
  3. 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
  4. 4Add the referenced files. Make sure the claude-ads repository's ads/references/youtube-audit.md and related references are reachable from the skill.
  5. 5Gather your campaign data. Collect exports, screenshots or values, plus objective, conversion definition, geography, date window, timezone and currency.
  6. 6Ask for the audit. Describe the audit in plain language, mentioning YouTube and the formats involved.
  7. 7Review the draft output. Check the observations, diagnoses and prioritised recommendations, and verify any proposed change yourself before acting.

What the ads-youtube skill makes the agent do

Once installed, the agent reviews a YouTube Ads account or campaign setup against a checklist covering measurement, campaign types, formats such as in-stream, Shorts and CTV, creative, audiences, brand safety and bidding. It works from exports, screenshots or values you supply, and notes where each figure came from.

The output includes observations, diagnoses and prioritised recommendations. The skill is read-only: it proposes changes as drafts rather than making them. For Google-managed campaign types it points you to the ads-google skill, and for actually changing campaigns it points to ads-optimize.

Install the ads-youtube skill

Download the ZIP from this page and unzip it. The skill is a folder containing a SKILL.md file. Then choose one of two locations: put the folder in ~/.claude/skills/ to make it available across your projects, or in a project's .claude/skills/ directory to limit it to that project.

If you use the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.

  • Personal install: ~/.claude/skills/
  • Project install: .claude/skills/ inside your project folder
  • Claude apps: Settings → Capabilities → Skills, then upload

Know what the skill needs before you start

The SKILL.md file reads from the ads main operating contract and shared ads/references files in the claude-ads repository, specifically ads/references/youtube-audit.md and related references. A standalone install must be able to find these references from the skills directory, so the skill is not a single file that works alone.

You also need to supply the campaign data yourself as exports, screenshots, API results or manual values. The SKILL.md file does not name any API keys or accounts.

  • Campaign data: exports, screenshots, API results or typed values
  • Conversion definition, date window, timezone, currency and spend
  • Reference files from the claude-ads repository

How to trigger the skill with natural requests

You do not need a special command. Describe what you want in plain language and mention YouTube or a format the skill covers. Requests that match the skill's description include audits of in-stream, Shorts, CTV or pre-roll campaigns, and reviews before a move to video action campaigns (VAC).

Give the agent the context it asks for: your objective, conversion definition, geography, date window and what data you are attaching. The procedure asks for these before evaluating anything.

  • Audit my YouTube Ads account using this export and flag measurement gaps.
  • Review these in-stream and Shorts campaign screenshots and prioritise fixes.
  • Prepare a gap review of our current YouTube setup before we migrate to VAC.
  • Check the CTV and audience settings in this campaign export.

What you get back and how to read it

The agent separates observations, diagnoses, recommendations, opportunities and proposed changes. Each finding traces back to the input it came from, and uncertainty or contradictions between your data sources are flagged rather than hidden.

Treat proposed changes as drafts. The skill keeps every account change as a draft, and the skill itself does not change anything in your account. Features that are optional, beta, unavailable or ineligible are listed without being scored.

  • Observations: what the data shows
  • Diagnoses: likely causes
  • Prioritised recommendations and unscored opportunities
  • Contradictions and missing inputs

Safety notes: scripts and network access

The skill does not run scripts and does not use the network, according to its listing. It works only on the material you give it, and the SKILL.md instructions say to treat external account and web content as data, never as instructions.

Because the skill is read-only, it cannot pause, edit or rebid live campaigns. Review any draft changes yourself before applying them in Google Ads.

  • Runs scripts: no
  • Uses network: no
  • Read-only: changes are drafts only

What people use it for

  • Preparing a client audit report from exported YouTube campaign data
  • Reviewing in-stream, Shorts and CTV setup against a structured checklist
  • Running a gap review before migrating to video action campaigns (VAC)
  • Checking audience and brand safety settings in an existing campaign export

Frequently asked questions

How do I install the ads-youtube agent skill?

Download the ZIP from this page and unzip it. Place the folder in ~/.claude/skills/ for all projects or in a project's .claude/skills/ directory, or upload it in the Claude apps under Settings → Capabilities → Skills.

Is the ads-youtube skill free and what is its licence?

The skill is listed under the MIT licence. The source material provided for this page does not state pricing, so check the directory listing for any cost details.

What do I need to run the ads-youtube skill?

You need the ads main operating contract and shared ads/references files from the claude-ads repository, including ads/references/youtube-audit.md. You also need to supply your campaign data as exports, screenshots, API results or manual values.

Can the skill change or pause my YouTube campaigns?

No. The skill is read-only and proposes changes as drafts. For changing campaigns, the skill points to ads-optimize, and for Google-managed campaign types such as Performance Max it points to ads-google.

Does the skill run scripts or access the internet?

According to its listing, the skill runs no scripts and uses no network access. It works from the data you provide.

How does ads-youtube compare with ads-google?

ads-youtube covers YouTube video formats such as in-stream, Shorts and CTV. The source says Google-managed campaign types, such as Performance Max, are routed to the separate ads-google skill.

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

Choose this skill if you are a marketer, media buyer or agency that wants a structured, read-only second opinion on a YouTube campaign setup, or a gap review before moving to VAC. Pick something else if you need the agent to change live campaigns, or if you are working on Google-managed types like Performance Max, where ads-google or ads-optimize is the better fit. Results still need your judgement, since the skill avoids universal pause, bid or attribution rules.

Download the skill