Sxo
nowork-studio/notfair-plugin
Search Experience Optimization (SXO), the bridge between SEO and UX/CRO.
Explains Google Ads API concepts, code snippets, or queries using plain language and analogies.
Install Explain
$ npx skills add googleads/google-ads-api-developer-assistant --skill explain -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install googleads/google-ads-api-developer-assistant explain --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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/explain .claude/skills/explain && rm -rf skills-srcUse ~/.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/
Install the "explain" agent skill from https://github.com/googleads/google-ads-api-developer-assistant/tree/main/plugins/google-ads-api-developer-assistant/skills/explain into .claude/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/googleads/google-ads-api-developer-assistant/tree/main/plugins/google-ads-api-developer-assistant/skills/explainType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add googleads/google-ads-api-developer-assistant --skill explain -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install googleads/google-ads-api-developer-assistant explain --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/googleads/google-ads-api-developer-assistant.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/google-ads-api-developer-assistant/skills/explain .agents/skills/explain && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "explain" agent skill from https://github.com/googleads/google-ads-api-developer-assistant/tree/main/plugins/google-ads-api-developer-assistant/skills/explain into .agents/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add googleads/google-ads-api-developer-assistant --skill explain -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install googleads/google-ads-api-developer-assistant explain --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/googleads/google-ads-api-developer-assistant.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/google-ads-api-developer-assistant/skills/explain .cursor/skills/explain && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "explain" agent skill from https://github.com/googleads/google-ads-api-developer-assistant/tree/main/plugins/google-ads-api-developer-assistant/skills/explain into .cursor/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/googleads/google-ads-api-developer-assistant.git --path plugins/google-ads-api-developer-assistant/skills/explain--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add googleads/google-ads-api-developer-assistant --skill explain -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install googleads/google-ads-api-developer-assistant explain --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/googleads/google-ads-api-developer-assistant.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/google-ads-api-developer-assistant/skills/explain .gemini/skills/explain && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "explain" agent skill from https://github.com/googleads/google-ads-api-developer-assistant/tree/main/plugins/google-ads-api-developer-assistant/skills/explain into .gemini/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install googleads/google-ads-api-developer-assistant explainInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add googleads/google-ads-api-developer-assistant --skill explain -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/googleads/google-ads-api-developer-assistant.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/google-ads-api-developer-assistant/skills/explain .github/skills/explain && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "explain" agent skill from https://github.com/googleads/google-ads-api-developer-assistant/tree/main/plugins/google-ads-api-developer-assistant/skills/explain into .github/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add googleads/google-ads-api-developer-assistant --skill explain -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install googleads/google-ads-api-developer-assistant explain --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/googleads/google-ads-api-developer-assistant.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/google-ads-api-developer-assistant/skills/explain .opencode/skills/explain && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "explain" agent skill from https://github.com/googleads/google-ads-api-developer-assistant/tree/main/plugins/google-ads-api-developer-assistant/skills/explain into .opencode/skills/explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explain", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
explain- GitHub stars
- 100
- Token cost
- ~507 tokens
- SKILL.md length
- 273 words
- Files
- 1
- Skills in repo
- 9
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Explains Google Ads API concepts, code snippets, or queries using plain language and analogies.
- Works in 4 steps: The Big Picture → Analogy [MANDATORY] → Interconnectedness → …
- Tasks that involve Paid advertising
- SKILL.md covers Protocol and Example Explanation
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Explain is an agent skill from googleads/google-ads-api-developer-assistant. Explains Google Ads API concepts, code snippets, or queries using plain language and analogies.
Its SKILL.md is about 510 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 and Plain language and style rules. It works with Google Ads. The licence is Apache-2.0.
When your agent uses it
- Tasks that involve Paid advertising
- Tasks that involve Plain language and style rules
Example prompts
- “Use the explain skill to explain Google Ads API concepts, code snippets, or queries using plain language and analogies”
- “/explain”
Workflow steps
4 steps, taken from the step headings in SKILL.md.
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
Explain loads about 507 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 273 words of instructions outside code blocks.
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). 273 words, ~507 tokens.
Download SKILL.mdSave it as
.claude/skills/explain/SKILL.md (or your agent's skills folder).- name
- explain
- description
- Explains Google Ads API concepts, code snippets, or queries using plain language and analogies.
Explain
Use this skill to explain Google Ads API concepts, code snippets, or queries. This ensures explanations are accessible to both technical and non-technical stakeholders while maintaining technical accuracy.
Protocol
When asked to explain a concept, you MUST structure your response with the following four sections:
1. The Big Picture
Provide a high-level summary of the fundamental problem this concept solves for the entire system. Limit this to 1-2 direct sentences.
2. Analogy [MANDATORY]
You MUST use a real-world, non-technical analogy to explain the concept. Map the technical components to everyday objects or processes.
- Constraint: Do not use technical jargon in the analogy itself.
3. Interconnectedness
Describe how this concept interacts with other core components of the Google Ads API. Mention specific resources or services it links to.
4. Simple Language
Create a distinct section titled "Simple Language" to summarize the concept in a way that is accessible to non-technical users, without losing technical correctness.
Example Explanation
Concept: click_view
The Big Picture
click_view retrieves performance metrics at the individual click level, allowing advertisers to trace conversions back to the specific click event.
Analogy
Think of a standard report as your monthly credit card statement summary (which only shows the total spent). click_view is the itemized receipt from a specific store visit, showing exactly what was bought, when, and the exact price for that single transaction.
Interconnectedness
It links directly to campaign and ad_group via their resource names, allowing you to associate individual click data with the hierarchy of your ad account.
Simple Language
It lets you see details for every single click on your ad, rather than just summaries of clicks over time.
© 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/explain of googleads/google-ads-api-developer-assistant.
Open the folder on GitHubat commit dbb730a
Compare with similar skills
Explain 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Explain this skillgoogleads/google-ads-api-developer-assistant | 100 | — | ~507 | Automated safety check: Pass | Apache-2.0 | |
| Sxonowork-studio/notfair-plugin | 3.9k | — | ~886 | Automated safety check: Pass | MIT | |
| Ads Copywriterclaude-office-skills/skills | 498 | — | ~2.1k | Automated safety check: Pass | MIT | |
| Client Report Narrativesirinabuht12-oss/marketing-skills | 3.8k | — | ~665 | Automated safety check: Pass | None | |
| Weekly Account Summaryirinabuht12-oss/marketing-skills | 3.8k | — | ~758 | Automated safety check: Pass | None | |
| Ad Copy Writercognyai/claude-code-marketing-skills | 104 | — | ~595 | Automated safety check: Notes | None |
Similar skills
Ads Copywriter
claude-office-skills/skills
Multi-platform ad copy generation for Google Ads, Meta/Facebook, TikTok, LinkedIn with A/B testing variants
Client Report Narratives
irinabuht12-oss/marketing-skills
Takes your raw campaign performance data and writes the executive summary paragraph that goes at the top of the report.
Weekly Account Summary
irinabuht12-oss/marketing-skills
Generates a plain English summary of everything that happened across all your accounts this week.
Ad Copy Writer
cognyai/claude-code-marketing-skills
Generate ad copy variations for Google, Meta, and LinkedIn Ads
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…
More from googleads/google-ads-api-developer-assistant
All 9 skills in this repoSync 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.
Ext Version
googleads/google-ads-api-developer-assistant
Retrieves the current version of the Google Ads API Developer Assistant from plugin.json.
Troubleshoot Conversions
googleads/google-ads-api-developer-assistant
Investigates conversion upload issues, generates structured diagnostic reports, and validates conversion CSVs.
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).
Assistant Tutorial
googleads/google-ads-api-developer-assistant
An interactive tutorial on how to use the Google Ads API Developer Assistant.
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.
Related
Works with
Categories
Questions about Explain
What does Explain do?
Explains Google Ads API concepts, code snippets, or queries using plain language and analogies. Explain is an agent skill from googleads/google-ads-api-developer-assistant. Explains Google Ads API concepts, code snippets, or queries using plain language and analogies.
When should I use Explain?
Explain fits situations like: tasks that involve Paid advertising; tasks that involve Plain language and style rules.
How do I install Explain in Claude Code?
Run `npx skills add googleads/google-ads-api-developer-assistant --skill explain -a claude-code`. Or copy the skill folder (plugins/google-ads-api-developer-assistant/skills/explain in googleads/google-ads-api-developer-assistant) into .claude/skills/explain in your project. Claude Code loads it when a task matches its description.
How do I install Explain in Codex?
Run `npx skills add googleads/google-ads-api-developer-assistant --skill explain -a codex`. Or copy the skill folder (plugins/google-ads-api-developer-assistant/skills/explain in googleads/google-ads-api-developer-assistant) into .agents/skills/explain in your project. Codex loads it when a task matches its description.
Can I use Explain 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 explain -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/explain, .gemini/skills/explain, .github/skills/explain and .opencode/skills/explain in your project.
What does Explain need to run?
SKILL.md names no scripts, command-line tools or credentials: Explain is instructions for the agent only.
Does Explain 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 Explain 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 Explain use?
Explain 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 Explain use?
About 507 tokens (SKILL.md is roughly 2k 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 Explain?
Skills that share tags, products or a category with Explain: Sxo (nowork-studio/notfair-plugin, 3.9k stars), Ads Copywriter (claude-office-skills/skills, 498 stars), Client Report Narratives (irinabuht12-oss/marketing-skills, 3.8k stars) and Weekly Account Summary (irinabuht12-oss/marketing-skills, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Explain?
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.