Home / coupler-io / skills · capability/google-ads-custom-gaql/SKILL.md · GitHub

google-ads-custom-gaql skillA

google-ads-custom-gaql is agent-read markdown (skill) from coupler-io/skills: Use this skill when the user needs Google Ads data that no packaged report type carries, or asks for a Custom GAQL source. Triggers include: 'I need a Google Ads field that isn't in any report', 'can I get hourly Google Ads data', 'break conversions down by action at ad group level', 'product-level Shopping data', 'write me a GAQL query', 'query the Google Ads API directly', or another Google Ads skill reporting that a metric exists in no report type. Configures the source; the analysis belongs .

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Google Ads Custom GAQL

You configure Custom GAQL sources on Coupler.io dataflows. The Google Ads source exposes 57 packaged report types plus a Custom GAQL option that accepts a raw Google Ads Query Language query. Your job is to determine which of those the user actually needs, and to build the source correctly when the answer is GAQL.

Custom GAQL costs the user things the packaged types give for free: labelled columns, currency conversion, and a curated default column set. Most requests that sound like GAQL are a packaged report type nobody went looking for. Step 2 exists to catch that.

Composes with `create-dataflow` — that skill owns dataflow creation end to end. Use it when no dataflow exists yet, then return here for the source configuration.

## Workflow

Follow these steps in order. Do not create a source until the query is built and the resource is confirmed.

### Step 1: Parse User Intent

Extract from the request:

- **The field or metric** they can't find
- **The grain** — one row per what? Campaign, ad group, keyword, search term, product, hour
- **The date window** — and whether it should roll or stay fixed
- **The ad account**, if they named one
…

Read the whole file at its exact version.

How to install

Latest version
mdr add coupler-io/skills/google-ads-custom-gaql@git:20260905.0af2a91
Exact content
mdr add coupler-io/skills/google-ads-custom-gaql@sha256:e4209a0a00350533

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6nfj5cok52lgdscj.svg)](https://markdownregistry.com/a/art_6nfj5cok52lgdscj)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260905.0af2a91 latest2026-09-05 0af2a91 12,217 BA view · diff
git:20260905.60bf8b02026-09-05 60bf8b0 9,765 BA view · diff
git:20260905.68cacec2026-09-05 68cacec 9,889 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12217 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

coupler-io/skills · 34 stars · license none · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6nfj5cok52lgdscj
GET https://markdownregistry.com/api/v1/resolve?ref=coupler-io/skills/google-ads-custom-gaql
GET https://markdownregistry.com/api/v1/blob/e4209a0a00350533a370272b7b81a80b3cdf9aebb5323ccbeb146d880efa79b7

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from coupler-io/skills

create-dataflow skill
coupler-io/skills · capability/create-dataflow/SKILL.md · Use this skill when the user wants to create a new dataflow, set up a new data import, connect a new data source to a…
git:20260826.260c8c0 · audit A · 34 stars
generate-data-set-context skill
coupler-io/skills · capability/generate-data-set-context/SKILL.md · Use this skill when the user wants to explore a dataset's context, or write or update documentation for the data it…
git:20260826.260c8c0 · audit A · 34 stars
get-started skill
coupler-io/skills · capability/get-started/SKILL.md · Use this skill when the user's Coupler.io workspace is NEW or EMPTY — no datasets, no credentials — and they want their…
v0.1.0 · audit A · 34 stars
refine-prompt skill
coupler-io/skills · capability/refine-prompt/SKILL.md · Use this skill when the user's request is vague, incomplete, or poorly structured and needs to be sharpened into a…
git:20260826.260c8c0 · audit A · 34 stars
report-generation skill
coupler-io/skills · capability/report-generation/SKILL.md · Use this skill to produce a structured business report from analysis output and validate it before delivery — turning…
git:20260826.260c8c0 · audit A · 34 stars
ecom-analytics skill
coupler-io/skills · ecommerce/ecom-analytics/SKILL.md · Use this skill when the user wants to analyze e-commerce performance, review funnel conversion, investigate AOV or…
git:20260827.ea5b9df · audit A · 34 stars
shopify-inventory-and-stockout-risk skill
coupler-io/skills · ecommerce/shopify/shopify-inventory-and-stockout-risk/SKILL.md · Use for "what's about to run out", "what should I reorder", "when do I need to place the order", "how much stock do I…
v1.0.0 · audit B · 34 stars
shopify-product-and-variant-sales skill
coupler-io/skills · ecommerce/shopify/shopify-product-and-variant-sales/SKILL.md · Use for "which products are selling", "what are my best sellers", "which variants should I drop", "what's my margin by…
v1.0.0 · audit B · 34 stars
shopify-repeat-purchase-and-retention skill
coupler-io/skills · ecommerce/shopify/shopify-repeat-purchase-and-retention/SKILL.md · Use for "what's our repeat rate", "do customers come back", "which campaign brings customers who buy again", "what's…
v1.0.0 · audit B · 34 stars
shopify-store-performance skill
coupler-io/skills · ecommerce/shopify/shopify-store-performance/SKILL.md · Use for Shopify store questions like "how did the store do last month", "why did our store revenue drop", "what's our…
v1.1.0 · audit B · 34 stars
finance-analytics skill
coupler-io/skills · finance/finance-analytics/SKILL.md · Use this skill when the user wants to analyze financial performance, review P&L health, monitor MRR/ARR, investigate…
git:20260827.ea5b9df · audit A · 34 stars
facebook-ads-audience-analysis skill
coupler-io/skills · marketing-and-ads/facebook-ads/facebook-ads-audience-analysis/SKILL.md · Use for "which audiences are working on Meta", "is my lookalike better than broad", "is retargeting worth it", "who is…
v1.0.0 · audit A · 34 stars

Every file in coupler-io/skills

Browse by kind, by grade A, or by owner.