Tracking Schema Designer (GA4/GTM)

Designs, validates, and finalizes GA4/GTM event schemas into an approval-ready tracking plan.

Data & AnalyticsIntermediate★ 136⑂ 39AI score 9/10Last updated: Apr 29, 2026

What it does

Takes a confirmed site-analysis.json (or an existing event-schema.json) and produces an event schema aligned with GA4/GTM industry standards.
Walks through the CLI pipeline: prepare-schema → validate-schema --check-selectors → generate-spec → confirm-schema.
Selector validation launches real Chromium via Playwright to test every schema selector against the live site.
Presents results as a compact tracking plan in a fixed order: Event Table, Common Properties, Event-specific Properties, with an optional appendix comparing against an existing live GTM baseline.
Emits event-schema.json, optional event-spec.md, schema-decisions.jsonl, restore snapshots, and an updated workflow-state.json.
Hard stop boundary: it will not proceed to GTM generation until you explicitly approve the schema and its parameters.

Who it's for

Analytics, growth, and marketing practitioners who repeatedly design GA4 events and GTM tags.
Teams cleaning up noisy legacy tracking plans and standardizing event naming/parameters.
Anyone who needs a documented event spec before handing implementation to developers.

Examples

"Build an event schema from site-analysis.json" → returns a journey-based event table plus common and event-specific parameters.
"Verify my selectors actually fire" → Playwright checks each selector on the live site and reports failures.
"Compare the new schema with our current GTM setup" → generates a comparison doc showing fixed issues and added reporting value.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/jtrackingai/analytics-tracking-automation/HEAD/skills/tracking-schema/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)

Download the ZIP with the button below.
In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.

↓ Download ZIP

Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the skills/tracking-schema folder from the GitHub repo jtrackingai/analytics-tracking-automation into my ~/.claude/skills/tracking-schema/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/jtrackingai/analytics-tracking-automation.git && mkdir -p ~/.claude/skills && cp -r analytics-tracking-automation/skills/* ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Open a terminal and go to your working directory.
Clone the repo: git clone https://github.com/jtrackingai/analytics-tracking-automation.git
Create the skills directory: mkdir -p ~/.claude/skills
Copy the skills in: cp -r analytics-tracking-automation/skills/* ~/.claude/skills/
- The skill references a shared references/ folder and the ./event-tracking CLI, so keeping the repo intact and running Claude Code from the repo root is the safest setup.
For selector checks, install Playwright and Chromium (e.g. npx playwright install chromium). Skip that flag in sandboxes without outbound network or browser access.
Restart Claude Code and ask something like "design a GA4 event tracking schema for this site".
Review the tracking-plan summary and only approve when satisfied — approval is required before the GTM generation step.

View source on GitHub ↗License: Apache-2.0