Gaql Reference
Google Ads Query Language (GAQL) Reference — complete syntax, resource types, fields, operators, date macros, and ready-to-use query patterns
Install
npx skills add cognyai/claude-code-marketing-skills --skill gaql-referencegit clone --depth 1 https://github.com/cognyai/claude-code-marketing-skills.git /tmp/claude-code-marketing-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-code-marketing-skills/skills/gaql-reference ~/.claude/skills/gaql-referencePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Google Ads Query Language (GAQL) Reference Complete reference for GAQL syntax, resource types, fields, operators, date macros, and common query patterns for Google Ads reporting and optimization. Full docs: https://cogny.com/docs/gaql-reference ## Usage ``` /gaql-reference # Show full syntax overview /gaql-reference search terms # Search terms report pattern /gaql-reference quality score # Quality Score analysis query /gaql-reference impression share # Budget & impression share query /gaql-reference geographic # Geographic performance query /gaql-reference change history # Change history audit query ``` ## Instructions You are a Google Ads Query Language (GAQL) expert. Use this reference to help users write correct GAQL queries, understand resource types, choose the right fields, and avoid common pitfalls. When the user asks a question, find the relevant section below and provide precise, actionable answers with ready-to-use GAQL examples. If the user provides a specific topic as an argument, focus on that area. Otherwise, provide an overview of the GAQL syntax and available resources. When the user has Cogny MCP tools available, prefer using `mcp__cogny__mcp__Google_Ads__tool_execute_gaql` to run queries directly and `mcp__cogny__mcp__Google_Ads__tool_get_gaql_doc` or `mcp__cogny__mcp__Google_Ads__tool_get_reporting_view_doc` for API documentation lookups. ## Run it live
Details
- Skill name
gaql-reference- Repository
- cognyai/claude-code-marketing-skills
- Path
skills/gaql-reference/SKILL.md- Repo updated
- 12 October 2026
FAQ
What does the Gaql Reference skill do?
Google Ads Query Language (GAQL) Reference — complete syntax, resource types, fields, operators, date macros, and ready-to-use query patterns
How do I install the Gaql Reference skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Gaql Reference popular?
It lives in cognyai/claude-code-marketing-skills, which has 114 GitHub stars and 16 forks, and is included in 3 curated skill lists.
Related skills
Ad Copy Writer
114cognyai/claude-code-marketing-skills
Generate ad copy variations for Google, Microsoft, Meta, LinkedIn, TikTok, Reddit, Snapchat and X Ads (plus Apple Search Ads guidance)
Ad Kill Rules
114cognyai/claude-code-marketing-skills
Enforce a pre-declared evidence bar on every ad — after it spends enough, pause it if it misses (e.g. CTR < 1% or cost per lead over cap) across Meta, TikTok, LinkedIn, Google and Bing — as a dry-run report, an approved pause, or a scheduled pause-only Cogny script
Brand Kit
114cognyai/claude-code-marketing-skills
Build a portable brand-kit.json for the user's product — colors, typography, voice — that other skills (video, ad creative, landing page) can consume. Multiple discovery paths so it works whether the user has access to their site's source code or only a public URL or just a logo image.
Google Ads Audit
114cognyai/claude-code-marketing-skills
Deep Google Ads account audit — keywords, quality scores, budget pacing, search terms
Demand Gen Audit
114cognyai/claude-code-marketing-skills
Google Ads Demand Gen audit — audience strategy, creative format diversity, creative freshness, placements, CPA vs goal
Google Ads Audit
114cognyai/claude-code-marketing-skills
Comprehensive Google Ads account audit (Microsoft Ads side by side when connected) — campaign structure, budget pacing, conversion tracking, wasted spend — across every campaign type, ranked by estimated $ impact
Browse the most popular Claude skills, all marketing, sales & business skills, or write your own with the skills generator.