Agent skill

Google Analytics

by superdesigndev in superdesigndev/treg

Traps to avoid when querying Google Analytics 4 through treg — cases where the GA4 Data API returns a confident wrong answer instead of an error.

Custom licenceAuto-check passedMarketing & SEO

Install Google Analytics

skills CLI
$ npx skills add superdesigndev/treg --skill google-analytics -a claude-code

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

GitHub CLI
$ gh skill install superdesigndev/treg google-analytics --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/superdesigndev/treg.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/google-analytics .claude/skills/google-analytics && 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
google-analytics
GitHub stars
4.5k
Token cost
~1.3k tokens
SKILL.md length
560 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

Traps to avoid when querying Google Analytics 4 through treg — cases where the GA4 Data API returns a confident wrong answer instead of an error.

  • Works in 6 steps: endDate:"today" silently includes a… → Zero does not mean zero — check whether… → A zero-row response has NO rows key at all → …
  • Answering questions about site traffic
  • SKILL.md covers 1. endDate:"today" silently…, 2. Zero does not mean zero —…, 3. A zero-row response has NO… and 3b. Don't list dateRange as a…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Google Analytics is an agent skill from superdesigndev/treg. Traps to avoid when querying Google Analytics 4 through treg — cases where the GA4 Data API returns a confident wrong answer instead of an error. Use whenever answering questions about site traffic, visitors, pageviews, channels, conversions, or revenue from GA4.

Its SKILL.md is about 1.3k 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. It works with Google Analytics. The repository describes itself as: OpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn.

When your agent uses it

  • Answering questions about site traffic
  • Revenue from GA4

Example prompts

  • “Use the google-analytics skill to trap to avoid when querying Google Analytics 4 through treg — cases where the GA4 Data API returns a confident…”
  • “/google-analytics”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. endDate:"today" silently includes a partial day
  2. Zero does not mean zero — check whether it's even tracked
  3. A zero-row response has NO rows key at all
  4. Dimension sums do NOT equal totals — they overcount
  5. limit defaults to 10,000 and truncates silently
  6. The Admin API is a different host and is unreachable via /call/

What it can do on your machine

Read from SKILL.md and the folder at commit e609803. 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 (its code samples are bash).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • developers.google.com

    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

Google Analytics loads about 1.3k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 560 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 560 words (~1,262 tokens).

“You already know the GA4 Data API. This file is only the things that return a plausible wrong answer with no error. Everything here was verified live on 2026-07-22, and each trap was confirmed by watching three independent agents walk…”

— opening of SKILL.md by superdesigndev, Custom licence
name
google-analytics

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/google-analytics of superdesigndev/treg.

Open the folder on GitHubat commit e609803

Compare with similar skills

Google Analytics 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.

Google Analytics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Analytics this skillsuperdesigndev/treg4.5k—~1.3kAutomated safety check: PassCustom licence
Google SEO APIsAgriciDaniel/claude-seo18k1 repos~4.2kAutomated safety check: PassMIT
AnalyticsNexus-JPF/note-companion8696 repos~2.2kAutomated safety check: PassMIT
Blog GoogleAgriciDaniel/claude-blog2.3k1 repos~3.3kAutomated safety check: NotesMIT
Google Analyticsthatrebeccarae/claude-marketing1624 repos~1.3kAutomated safety check: NotesMIT
AI VisibilityRyze-AI-Adgent/open-seo-mcp-skills4.4k—~611Automated safety check: PassMIT

Similar skills

  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    18k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • Analytics

    Nexus-JPF/note-companion

    When the user wants to set up, improve, or audit analytics tracking and measurement.

    869 GitHub starsUsed in 6 repos~2.2k tokens
    Marketing & SEOAuto-check passed
  • 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
  • Google Analytics

    thatrebeccarae/claude-marketing

    Analyze Google Analytics data, review website performance metrics, identify traffic patterns, and suggest data-driven improvements.

    162 GitHub starsUsed in 4 repos~1.3k tokens
    Marketing & SEOAuto-check: notes
  • AI Visibility

    Ryze-AI-Adgent/open-seo-mcp-skills

    Measure real AI-engine visibility — traffic from ChatGPT, Perplexity, Claude, Gemini and which pages they cite — from actual GA4 referral data, not prompt sampling.

    4.4k GitHub stars~611 tokensUpdated 13 days ago
    Marketing & SEOAuto-check passed
  • Soku CLI

    About-Intelligence/soku-cli

    Guides an agent through the soku command line tool for ads, GA4 and PostHog data reads, ads writes, SEO hosting, automations, files and skill management.

    304 GitHub stars~2.4k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed

More from superdesigndev/treg

All 12 skills in this repo
  • Add OAuth Provider

    superdesigndev/treg

    Add a provider to treg's OAuth registry (the ones treg holds its own approved app for).

    4.5k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Dev Local

    superdesigndev/treg

    One-command local dev stack for tools-registry. An agent skill from superdesigndev/treg.

    4.5k GitHub stars~623 tokensUpdated today
    Auto-check passed
  • Google Ads

    superdesigndev/treg

    Traps when running Google Ads through treg — the API requirements and cleanup semantics that cost round-trips or money.

    4.5k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Google Search Console

    superdesigndev/treg

    Traps to avoid when querying Google Search Console through treg — cases where the API returns a confident wrong answer instead of an error, especially around totals and recent-date trends.

    4.5k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Jev Memory

    superdesigndev/treg

    A skill your agent uses when the user wants Claude Code to remember their preferences across sessions, asks for a memory mod or memory harness for Claude Code, mentions the Jev memory classifier or…

    4.5k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Tools Registry Context

    superdesigndev/treg

    tools-registry context + doc upkeep. An agent skill from superdesigndev/treg.

    4.5k GitHub stars~1k tokensUpdated today
    Auto-check passed

Categories

Questions about Google Analytics

What does Google Analytics do?

Traps to avoid when querying Google Analytics 4 through treg — cases where the GA4 Data API returns a confident wrong answer instead of an error. Google Analytics is an agent skill from superdesigndev/treg. Traps to avoid when querying Google Analytics 4 through treg — cases where the GA4 Data API returns a confident wrong answer instead of an error.

When should I use Google Analytics?

Google Analytics fits situations like: answering questions about site traffic; revenue from GA4.

How do I install Google Analytics in Claude Code?

Run `npx skills add superdesigndev/treg --skill google-analytics -a claude-code`. Or copy the skill folder (.agents/skills/google-analytics in superdesigndev/treg) into .claude/skills/google-analytics in your project. Claude Code loads it when a task matches its description.

How do I install Google Analytics in Codex?

Run `npx skills add superdesigndev/treg --skill google-analytics -a codex`. Or copy the skill folder (.agents/skills/google-analytics in superdesigndev/treg) into .agents/skills/google-analytics in your project. Codex loads it when a task matches its description.

Can I use Google Analytics 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 superdesigndev/treg --skill google-analytics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-analytics, .gemini/skills/google-analytics, .github/skills/google-analytics and .opencode/skills/google-analytics in your project.

What does Google Analytics need to run?

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

Does Google Analytics access the network?

SKILL.md names 1 domain. As links in the text: developers.google.com. This is read from the text; nothing was executed.

Is Google Analytics 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 Google Analytics use?

Google Analytics has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Google Analytics use?

About 1.3k tokens (SKILL.md is roughly 5k 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 Google Analytics?

Skills that share tags, products or a category with Google Analytics: Google SEO APIs (AgriciDaniel/claude-seo, 18k stars), Analytics (Nexus-JPF/note-companion, 869 stars), Blog Google (AgriciDaniel/claude-blog, 2.3k stars) and Google Analytics (thatrebeccarae/claude-marketing, 162 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Analytics?

superdesigndev (a GitHub organization) maintains it in superdesigndev/treg, which has 4,540 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 7, 2026.

Source: superdesigndev/treg on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.