# gaql-reference

This skill helps draft Google Ads GAQL queries and understand their resources, fields, and filters. Use it when building a report query or checking its structure.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 111
- Author: Cogny AI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cognyai/claude-code-marketing-skills/tree/HEAD/skills/gaql-reference/SKILL.md
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/skills/gaql-reference

## What it does

The skill covers GAQL query structure, including selected fields, the resource being queried, filters, sorting, row limits, and parameters. Its reference includes resources for campaigns, ad groups, search terms, geographic performance, and change records. Ask for a query pattern on a specific subject, such as search-term reporting or Quality Score analysis.

With Cogny MCP tools connected, the skill can submit a Google Ads query and look up API documentation. The reference still works without that connection, but it cannot run queries. Microsoft Ads uses a separate reporting tool rather than GAQL, so Google Ads query syntax does not apply there.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gaql-reference/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gaql-reference/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gaql-reference/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gaql-reference/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cognyai/claude-code-marketing-skills gaql-reference
```

2. **Manually: put the files in place**
- File: `.github/skills/gaql-reference/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/gaql-reference
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gaql-reference/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cognyai/claude-code-marketing-skills/tree/HEAD/skills/gaql-reference/SKILL.md

## When to use it
- draft a GAQL report for triggered search queries
- choose a resource for geographic performance reporting
- filter campaigns by status and date range
- check a query's structure before running it
- find a query pattern for auditing account changes

## Example prompts
- Write a GAQL query for a Google Ads search-term report covering the last 30 days.
- Show me a query pattern for Quality Score analysis.
- Which resource should I use for a geographic performance report?

## Similar
- [seo-audit](https://affpapa.org/en/nevibecode/skills/coreyhaines31-seo-audit.md) — skill · 238500 installs
- [programmatic-seo](https://affpapa.org/en/nevibecode/skills/coreyhaines31-programmatic-seo.md) — skill · 150800 installs
- [copy-editing](https://affpapa.org/en/nevibecode/skills/coreyhaines31-copy-editing.md) — skill · 149800 installs
- [marketing-ideas](https://affpapa.org/en/nevibecode/skills/coreyhaines31-marketing-ideas.md) — skill · 147400 installs
- [sales-enablement](https://affpapa.org/en/nevibecode/skills/sales-enablement.md) — skill · 119400 installs
- [revops](https://affpapa.org/en/nevibecode/skills/revops.md) — skill · 114000 installs

From the same set: [cognyai/claude-code-marketing-skills](https://affpapa.org/en/nevibecode/by/cognyai/claude-code-marketing-skills.md) — 38 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md