https://github.com/jtrackingai/event-tracking-skill
Set up reviewable GA4 event tracking in GTM with site analysis, schema generation, sync, and preview verification.
https://github.com/jtrackingai/event-tracking-skill
agent-skill analytics claude-code claude-code-skill claude-skills event-tracking ga4 google-tag-manager gtm marketing-analytics open-source shopify tracking
Last synced: 14 days ago
JSON representation
Set up reviewable GA4 event tracking in GTM with site analysis, schema generation, sync, and preview verification.
- Host: GitHub
- URL: https://github.com/jtrackingai/event-tracking-skill
- Owner: jtrackingai
- License: apache-2.0
- Created: 2026-04-02T05:25:46.000Z (25 days ago)
- Default Branch: main
- Last Pushed: 2026-04-08T08:23:20.000Z (19 days ago)
- Last Synced: 2026-04-08T10:32:09.057Z (19 days ago)
- Topics: agent-skill, analytics, claude-code, claude-code-skill, claude-skills, event-tracking, ga4, google-tag-manager, gtm, marketing-analytics, open-source, shopify, tracking
- Language: TypeScript
- Homepage: https://www.jtracking.ai
- Size: 327 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
GA4 + GTM, done by AI. From site analysis to go live.
Works with Cursor · Codex · Any AI Agent
What You Get ·
Installation ·
Quick Start ·
Website
# Event Tracking Skill
`event-tracking-skill` is a local-first AI skill for planning, reviewing, and delivering GA4 + GTM tracking.
Use it when you want an agent to help with:
- analyzing a site before tracking work starts
- grouping pages by business purpose
- designing or reviewing a GA4 event plan
- comparing a proposed plan with an existing live GTM setup
- preparing GTM-ready outputs and verification guidance
- handling both generic websites and Shopify storefronts
This README is intentionally user-facing and conversation-first.
If you need the CLI surface or maintainer workflow, use [DEVELOPING.md](DEVELOPING.md).
## What You Get
For a given website, this skill can help produce:
- a reviewable site analysis
- business-friendly page groups
- a compact, decision-ready tracking plan
- GTM-ready tracking outputs
- verification and health summaries before go-live
- artifact-backed progress that can be resumed later
## Installation
Most users only need the umbrella skill.
### Recommended
Clone the repository locally, then install the skill into your agent skills directory:
```bash
git clone https://github.com/jtrackingai/event-tracking-skill.git
cd event-tracking-skill
npm run install:skills
```
### No-Clone Alternative
If you do not want to clone the repository, install the root skill directly:
```bash
npx skills add jtrackingai/event-tracking-skill
```
For advanced install options and exported skill bundles:
- [docs/README.install.md](docs/README.install.md)
- [docs/skills.md](docs/skills.md)
## Quick Start
### Use It As A Skill
The intended experience is simple: tell your agent what you want in plain language.
Good requests usually include one or more of:
- the site URL
- whether this is a new setup, update, upkeep, or audit
- an existing artifact directory if you already have one
- GA4 measurement ID or GTM context when you already know them
- any scope boundary such as "stop after schema review"
### Example Prompts
New setup from scratch:
```text
Use event-tracking-skill to plan GA4 + GTM tracking for https://www.example.com.
Start from a fresh run and stop after the event schema is ready for review.
```
New setup with implementation context:
```text
Use event-tracking-skill to set up tracking for https://www.example.com.
Use ./output as the output root.
GA4 Measurement ID is G-XXXXXXXXXX.
We care most about signup, pricing, contact, and demo intent.
```
Audit only:
```text
Use event-tracking-skill to run a tracking health audit for https://www.example.com.
I only want to understand the current live GTM setup and whether we should repair or rebuild.
Do not continue into deployment work.
```
Routine upkeep:
```text
Use event-tracking-skill to do an upkeep review for this existing run:
./output/example_com
Tell me what is still healthy, what drifted, and what needs repair.
```
Update an existing artifact:
```text
Use event-tracking-skill to resume this artifact directory:
./output/example_com
Tell me the current checkpoint and continue only through schema review.
```
Page-group review only:
```text
Use event-tracking-skill to review and refine the page groups in:
./output/example_com/site-analysis.json
Focus on business intent, not just URL shape.
```
Shopify branch:
```text
Use event-tracking-skill for this Shopify storefront:
https://store.example.com
I want the Shopify-specific tracking path, not the generic website flow.
```
## How To Think About It
This skill is best when you want the agent to act like a tracking lead, not just a command runner.
A typical conversation flow is:
1. inspect the site or resume an existing run
2. group pages in a reviewable way
3. draft or revise the event plan
4. review what should be reused, repaired, added, or dropped
5. continue into GTM generation and verification only when you explicitly want that
## Where To Go Next
- Installation details: [docs/README.install.md](docs/README.install.md)
- Skill family map: [docs/skills.md](docs/skills.md)
- Agent-facing workflow contract: [SKILL.md](SKILL.md)
- CLI and maintainer workflow: [DEVELOPING.md](DEVELOPING.md)
## Product Boundary
- the workflow runs locally
- GTM sync uses Google OAuth
- generic sites use automated preview verification
- Shopify uses the Shopify-specific branch and manual post-install validation
## Need A More Advanced Setup?
This skill reflects the implementation workflow behind [JTracking](https://www.jtracking.ai).
If you need a more advanced setup, JTracking also supports:
- richer tracking design based on business scenarios
- server-side tracking and custom loaders
- more destination and ad-platform integrations
- longer-term tracking operations and maintenance
## License
This project is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full text.
Use of the JTracking name, logo, and other brand assets is not granted under this license.