Analyze connected Google Analytics 4 traffic, acquisition

by nowork-studio · MIT license · ★ 3,853 on GitHub · updated Sep 24

Analyze connected Google Analytics 4 traffic, acquisition, engagement, landing pages, ecommerce, events, and conversions, and safely manage supported GA4 key events or custom dimensions through NotFair MCP. Use for GA4, Google…

---
name: google-analytics
description: Analyze connected Google Analytics 4 traffic, acquisition, engagement, landing pages, ecommerce, events, and conversions, and safely manage supported GA4 key events or custom dimensions through NotFair MCP. Use for GA4, Google Analytics, traffic or conversion drops, channel attribution, realtime activity, report requests, measurement configuration, or Analytics MCP setup.
argument-hint: "<property, date range, metric, or GA4 question>"
---

# Google Analytics

Read `../shared/operating-contract.md`. Use the live connector's instructions and schemas to choose tools for the task.

## Select the property and question

1. Resolve `~~google-analytics` to the actual GA4 connector and inspect its current tools. Confirm access and the available properties from live data.
2. Select the exact `properties/123456789` resource returned by the connector. Never substitute a `G-` measurement ID or Google account ID.
3. Define the business question, primary metric, conversion or key-event definition, property timezone, date range, and comparison window. If the platform is missing or unauthorized, direct the user to reconnect the universal NotFair plugin and stop before claiming live data.

## Pull decision-grade evidence

Overview

Read ../shared/operating-contract.md. Use the live connector's instructions and schemas to choose tools for the task.

Manual install (npx, ZIP)

Claude Codenpx skills add nowork-studio/notfair-plugin --skill google-analytics -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/nowork-studio/notfair-plugin/tar.gz/5229d2163795 \
  | tar -xz -C ~/.claude/skills --strip-components=2 notfair-plugin-5229d2163795/analytics/google-analytics

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/e1452753625da9b5aa4a/google-analytics.zip" -OutFile "$env:TEMP\google-analytics.zip"; Expand-Archive "$env:TEMP\google-analytics.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md3.2 KB
agents/1 file · 222 B
evals/1 file · 1.6 KB

Read the files here

nowork-studio/5229d213 files

SKILL.md3.2 KB

Shared references1SKILL.md reads these from elsewhere in the repo. Not in the ZIP.

operating-contract.mdanalytics/shared/1.3 KB

Get them on GitHub ↗

SKILL.md

Show the full text40 lines

google-analytics/SKILL.md40 lines · 3.2 KB

PreviewCode

Outline

RawView on GitHub

Google Analytics

Read ../shared/operating-contract.md. Use the live connector's instructions and schemas to choose tools for the task.

Select the property and question

Resolve ~~google-analytics to the actual GA4 connector and inspect its current tools. Confirm access and the available properties from live data.
Select the exact properties/123456789 resource returned by the connector. Never substitute a G- measurement ID or Google account ID.
Define the business question, primary metric, conversion or key-event definition, property timezone, date range, and comparison window. If the platform is missing or unauthorized, direct the user to reconnect the universal NotFair plugin and stop before claiming live data.

Pull decision-grade evidence

Pull the smallest useful set of reports across channel, source/medium, campaign, landing page, device, geography, or event. Choose available reporting capabilities and batch related reads when supported and useful.

Compare complete equivalent periods and show absolute values plus deltas.
Use metadata before guessing an unfamiliar dimension/metric pair. Respect the current API's dimension, metric, fan-out, and quota limits exposed by the tool.
Check response metadata for sampling, thresholding, or quota warnings. A collapsed (other) row means detailed rows may not sum to the total.
Treat recent/intraday data as provisional and state the property's timezone.
Keep GA4 attribution separate from ad-platform attribution. Explain discrepancies instead of blending incompatible numbers.
Do not claim causality from a correlated channel or page change without supporting evidence.

Lead with what changed, where it changed, the evidence-backed likely driver, confidence, and the next measurement or business action. Include the report definition so another operator can reproduce it.

Change measurement configuration

Use currently available capabilities for supported key-event and custom-dimension changes. Show the exact property, current state, proposed state, downstream reporting impact, and rollback before asking for approval.

Creating and deleting a key event are reversible counterparts when the same event definition is available.
Archiving a custom dimension is irreversible in GA4 and its parameter name cannot be reused. Require explicit approval that names the property and dimension before archiving.
Respect the read/write boundary described by the live capability.
Confirm success from returned before/after evidence or a fresh configuration read; report partial failures without retrying blindly.

Do not describe a report as saved or a dashboard as published unless the connected tool explicitly supports that operation and confirms it.

1	---
2	name: google-analytics
3	description: Analyze connected Google Analytics 4 traffic, acquisition, engagement, landing pages, ecommerce, events, and conversions, and safely manage supported GA4 key events or custom dimensions through NotFair MCP. Use for GA4, Google Analytics, traffic or conversion drops, channel attribution, realtime activity, report requests, measurement configuration, or Analytics MCP setup.
4	argument-hint: "<property, date range, metric, or GA4 question>"
5	---
6
7	# Google Analytics
8
9	Read `../shared/operating-contract.md`. Use the live connector's instructions and schemas to choose tools for the task.
10
11	## Select the property and question
12
13	1. Resolve `~~google-analytics` to the actual GA4 connector and inspect its current tools. Confirm access and the available properties from live data.
14	2. Select the exact `properties/123456789` resource returned by the connector. Never substitute a `G-` measurement ID or Google account ID.
15	3. Define the business question, primary metric, conversion or key-event definition, property timezone, date range, and comparison window. If the platform is missing or unauthorized, direct the user to reconnect the universal NotFair plugin and stop before claiming live data.
16
17	## Pull decision-grade evidence
18
19	Pull the smallest useful set of reports across channel, source/medium, campaign, landing page, device, geography, or event. Choose available reporting capabilities and batch related reads when supported and useful.
20
21	- Compare complete equivalent periods and show absolute values plus deltas.
22	- Use metadata before guessing an unfamiliar dimension/metric pair. Respect the current API's dimension, metric, fan-out, and quota limits exposed by the tool.
23	- Check response metadata for sampling, thresholding, or quota warnings. A collapsed `(other)` row means detailed rows may not sum to the total.
24	- Treat recent/intraday data as provisional and state the property's timezone.
25	- Keep GA4 attribution separate from ad-platform attribution. Explain discrepancies instead of blending incompatible numbers.
26	- Do not claim causality from a correlated channel or page change without supporting evidence.
27
28	Lead with what changed, where it changed, the evidence-backed likely driver, confidence, and the next measurement or business action. Include the report definition so another operator can reproduce it.
29
30	## Change measurement configuration
31
32	Use currently available capabilities for supported key-event and custom-dimension changes. Show the exact property, current state, proposed state, downstream reporting impact, and rollback before asking for approval.
33
34	- Creating and deleting a key event are reversible counterparts when the same event definition is available.
35	- Archiving a custom dimension is irreversible in GA4 and its parameter name cannot be reused. Require explicit approval that names the property and dimension before archiving.
36	- Respect the read/write boundary described by the live capability.
37	- Confirm success from returned before/after evidence or a fresh configuration read; report partial failures without retrying blindly.
38
39	Do not describe a report as saved or a dashboard as published unless the connected tool explicitly supports that operation and confirms it.
40