New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Assistant Tutorial

by googleads in googleads/google-ads-api-developer-assistant

An interactive tutorial on how to use the Google Ads API Developer Assistant.

Apache-2.0Auto-check passedMarketing & SEO

Install Assistant Tutorial

skills CLI
$ npx skills add googleads/google-ads-api-developer-assistant --skill assistant-tutorial -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install googleads/google-ads-api-developer-assistant assistant-tutorial --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/googleads/google-ads-api-developer-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/google-ads-api-developer-assistant/skills/assistant-tutorial .claude/skills/assistant-tutorial && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
assistant-tutorial
GitHub stars
100
Token cost
~1.1k tokens
SKILL.md length
550 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

An interactive tutorial on how to use the Google Ads API Developer Assistant.

  • Works in 5 steps: NO MD SYNOPSIS FILES: You MUST NOT write… → ALWAYS INTERACTIVE: You MUST run this… → TOPIC SELECTION: Start by asking the… → …
  • Tasks that involve Paid advertising
  • SKILL.md covers Critical Directive for the Agent and Tutorial Content Reference
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Assistant Tutorial is an agent skill from googleads/google-ads-api-developer-assistant. An interactive tutorial on how to use the Google Ads API Developer Assistant.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Paid advertising. It works with Google Ads. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Paid advertising

Example prompts

  • “/assistant-tutorial”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. NO MD SYNOPSIS FILES: You MUST NOT write any markdown files or artifacts summarizing the tutorial.
  2. ALWAYS INTERACTIVE: You MUST run this tutorial as an interactive, conversational experience.
  3. TOPIC SELECTION: Start by asking the user which specific topic they want to learn about first using an interactive question or message.
  4. PROGRESSIVE DISCLOSURE: Present information in small, manageable pieces. Ask checking questions or prompt the user to proceed before…
  5. EXPLAIN ANSWER OPTION: Whenever you pose an interactive check question or quiz to the user, include a choice/option that allows them to…

What it can do on your machine

Read from SKILL.md and the folder at commit dbb730a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Assistant Tutorial loads about 1.1k tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 550 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from googleads/google-ads-api-developer-assistant at commit dbb730a, republished under its Apache-2.0 licence (© googleads). 550 words, ~1,142 tokens.

Download SKILL.mdSave it as .claude/skills/assistant-tutorial/SKILL.md (or your agent's skills folder).
name
assistant-tutorial
description
An interactive tutorial on how to use the Google Ads API Developer Assistant.

Google Ads API Developer Assistant Tutorial (Interactive Guide)

[!NOTE]

  • If you want a real-world analogy and conceptual explanation for any Google Ads API concept, use the /explain <concept> command.
  • If you want to walk through a process or workflow step-by-step, use the /step-by-step <process> command.

Critical Directive for the Agent

When a user invokes /assistant-tutorial or requests this tutorial:

  1. NO MD SYNOPSIS FILES: You MUST NOT write any markdown files or artifacts summarizing the tutorial.
  2. ALWAYS INTERACTIVE: You MUST run this tutorial as an interactive, conversational experience.
  3. TOPIC SELECTION: Start by asking the user which specific topic they want to learn about first using an interactive question or message.
  4. PROGRESSIVE DISCLOSURE: Present information in small, manageable pieces. Ask checking questions or prompt the user to proceed before moving on to the next step.
  5. EXPLAIN ANSWER OPTION: Whenever you pose an interactive check question or quiz to the user, include a choice/option that allows them to ask the Assistant to answer and explain the answer.

Tutorial Content Reference

Topic 1: Core Principles & Constraints
  • The "NO MUTATE" Read-Only Policy: The Assistant cannot execute mutate operations (such as create, update, or delete) directly. Instead, it provides the code for the mutate in the ~/saved/code/ directory, which the user can run themselves or incorporate into their codebase.
  • API Versioning: All code and GAQL queries target the confirmed version in config/api_version.txt.
Topic 2: Campaign Creation (Code Generation Workflow)
  • Explain the generation & execution workflow.
  • Show standard template structures.
  • NO MUTATE Execution Warning: Remind the user that the Assistant is designed for read-only operations and cannot execute campaign creation mutate code directly.
Topic 3: Shared Sets (Exclusion Lists)
  • Explain SharedSet (reusable keyword/placement exclusion folders), SharedCriterion (items), and CampaignSharedSet (connector).
  • Describe relationships and benefits.
Topic 4: Code Quality & Standards
  • Detail automated linting (ruff), type annotations, and error handling (GoogleAdsException wrapper) that the assistant enforces.
Topic 5: Finding Disapproved Ads (Cross-Account Audit)
  • Phase 1: Determine Parent Manager Account (MCC) using customer_manager_link.
  • Phase 2: Retrieve child accounts recursively using get_cids_under_mcc script.
  • Phase 3: Query disapproved ads via ad_group_ad resource.
Show full SKILL.md (206 more words)Show less
Topic 6: Creating an AI Max for Search Campaign
  • What is AI Max? Refers to "AI Max for Search campaigns", NOT "Performance Max" campaigns.
  • Enabling AI Max: Set ai_max_setting.enable_ai_max = True on the Campaign resource.
  • Campaign Configuration: advertising_channel_type = SEARCH, budget, bidding strategy like Maximize Conversions.
  • Ad Creation: RSA in AdGroupAd using ResponsiveSearchAdInfo.
Topic 7: Creating a Demand Gen Campaign
  • What is Demand Gen? Drives action across YouTube, Discover, and Gmail using image and video assets.
  • Campaign Configuration: advertising_channel_type = DEMAND_GEN.
  • Ad Group Settings: demand_gen_ad_group_settings.channel_controls.selected_channels.
Topic 8: Writing Prompts to Produce Reports
  • Prompting Best Practices: Define main resource, specify metrics, request date/device segments.
  • GAQL Validation Protocol: Programmatic 4-step sequence (Schema Discovery, Compatibility Check, Static Analysis, Runtime Dry Run).
Topic 9: Troubleshooting Conversion Problems
  • Diagnostic Protocol: Run troubleshoot_conversions.py for conversion upload issues.
  • Pre-Upload Validation: Run validate_conversion_upload.py to validate CSV formatting and logical time checks before uploading.
Topic 10: Obtaining Descriptions of API Concepts and Objects
  • Conceptual Explanations: Use /explain or ask for high-level summaries structured with Big Picture, Analogy, Interconnectedness, and Simple Language.
  • Structural Inspection: Use inspect_object.py to view raw field definitions, types, and Enum values.
Topic 11: Creating a Listing Filter for a Performance Max (PMax) Campaign
  • Webpage Listing Filter: Configure webpage exclusion listing trees (vertical = WEBPAGE) using create_pmax_webpage_filter.py.

© googleads, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/google-ads-api-developer-assistant/skills/assistant-tutorial of googleads/google-ads-api-developer-assistant.

Open the folder on GitHubat commit dbb730a

Compare with similar skills

Assistant Tutorial next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Assistant Tutorial compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Assistant Tutorial this skillgoogleads/google-ads-api-developer-assistant100—~1.1kAutomated safety check: PassApache-2.0
Blog GoogleAgriciDaniel/claude-blog2.3k1 repos~3.3kAutomated safety check: NotesMIT
AdsCesarjoquin/Marketing-Skills2001 repos~3.5kAutomated safety check: PassMIT
Adscoreyhaines31/marketingskills54k1 repos~7.8kAutomated safety check: PassMIT
Paid Adsfreekmurze/dotfiles1k14 repos~2.4kAutomated safety check: PassNone
Google Adszapier/connectors1761 repos~3.7kAutomated safety check: PassElastic-2.0

Similar skills

  • Blog Google

    AgriciDaniel/claude-blog

    Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…

    2.3k GitHub starsUsed in 1 repo~3.3k tokens
    Marketing & SEOAuto-check: notes

  • Ads

    Cesarjoquin/Marketing-Skills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    200 GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed

  • Ads

    coreyhaines31/marketingskills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    54k GitHub starsUsed in 1 repo~7.8k tokens
    Marketing & SEOAuto-check passed

  • Paid Ads

    freekmurze/dotfiles

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    1k GitHub starsUsed in 14 repos~2.4k tokens
    Marketing & SEOAuto-check passed

  • Google Ads

    zapier/connectors

    Official

    Agent-callable Google Ads tools — search campaigns, ad groups, and ads via GAQL, build performance reports, manage campaign status and budgets, and set up conversion tracking.

    176 GitHub starsUsed in 1 repo~3.7k tokens
    Marketing & SEOAuto-check passed

  • Money Ads

    iamzifei/show-me-the-money

    Paid advertising automation for Google Ads, Meta Ads, and other ad platforms.

    1k GitHub stars~2.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from googleads/google-ads-api-developer-assistant

All 9 skills in this repo

  • Sync Client Libs

    googleads/google-ads-api-developer-assistant

    Discovers Google Ads client libraries under clientlibs, verifies installed versions against GitHub latest releases, and automatically updates outdated codebases.

    100 GitHub stars~537 tokensUpdated 21 days ago
    Auto-check passed

  • Ext Version

    googleads/google-ads-api-developer-assistant

    Retrieves the current version of the Google Ads API Developer Assistant from plugin.json.

    100 GitHub stars~246 tokensUpdated 21 days ago
    Auto-check passed

  • Troubleshoot Conversions

    googleads/google-ads-api-developer-assistant

    Investigates conversion upload issues, generates structured diagnostic reports, and validates conversion CSVs.

    100 GitHub stars~310 tokensUpdated 21 days ago
    Auto-check passed

  • Explain

    googleads/google-ads-api-developer-assistant

    Explains Google Ads API concepts, code snippets, or queries using plain language and analogies.

    100 GitHub stars~507 tokensUpdated 21 days ago
    Auto-check passed

  • Get Cids Under Mcc

    googleads/google-ads-api-developer-assistant

    Retrieves a list of all child customer account IDs (CIDs) under a given Manager Account (MCC).

    100 GitHub stars~379 tokensUpdated 21 days ago
    Auto-check passed

  • Validate Gaql

    googleads/google-ads-api-developer-assistant

    Validates Google Ads Query Language (GAQL) queries via 4-step static analysis and live API dry-runs.

    100 GitHub stars~225 tokensUpdated 21 days ago
    Auto-check passed

Works with

Categories

Questions about Assistant Tutorial

What does Assistant Tutorial do?

An interactive tutorial on how to use the Google Ads API Developer Assistant. Assistant Tutorial is an agent skill from googleads/google-ads-api-developer-assistant. An interactive tutorial on how to use the Google Ads API Developer Assistant.

When should I use Assistant Tutorial?

Assistant Tutorial fits situations like: tasks that involve Paid advertising.

How do I install Assistant Tutorial in Claude Code?

Run `npx skills add googleads/google-ads-api-developer-assistant --skill assistant-tutorial -a claude-code`. Or copy the skill folder (plugins/google-ads-api-developer-assistant/skills/assistant-tutorial in googleads/google-ads-api-developer-assistant) into .claude/skills/assistant-tutorial in your project. Claude Code loads it when a task matches its description.

How do I install Assistant Tutorial in Codex?

Run `npx skills add googleads/google-ads-api-developer-assistant --skill assistant-tutorial -a codex`. Or copy the skill folder (plugins/google-ads-api-developer-assistant/skills/assistant-tutorial in googleads/google-ads-api-developer-assistant) into .agents/skills/assistant-tutorial in your project. Codex loads it when a task matches its description.

Can I use Assistant Tutorial in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add googleads/google-ads-api-developer-assistant --skill assistant-tutorial -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/assistant-tutorial, .gemini/skills/assistant-tutorial, .github/skills/assistant-tutorial and .opencode/skills/assistant-tutorial in your project.

What does Assistant Tutorial need to run?

SKILL.md names no scripts, command-line tools or credentials: Assistant Tutorial is instructions for the agent only.

Does Assistant Tutorial access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Assistant Tutorial safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Assistant Tutorial use?

Assistant Tutorial is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Assistant Tutorial use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Assistant Tutorial?

Skills that share tags, products or a category with Assistant Tutorial: Blog Google (AgriciDaniel/claude-blog, 2.3k stars), Ads (Cesarjoquin/Marketing-Skills, 200 stars), Ads (coreyhaines31/marketingskills, 54k stars) and Paid Ads (freekmurze/dotfiles, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Assistant Tutorial?

googleads (a GitHub organization) maintains it in googleads/google-ads-api-developer-assistant, which has 100 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 16, 2026.

Source: googleads/google-ads-api-developer-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.