add-analytics
di jeftekhari
Data & AnalyticsSintesi
Add Google Analytics 4 tracking to any project.
Descrizione
Cosa fa questa skill
Adds Google Analytics 4 tracking to a project by detecting the framework and inserting the appropriate gtag setup. Supports Next.js, Nuxt, Astro, SvelteKit, Remix, Gatsby, Vue, React (Vite/CRA), Angular, and plain HTML. Optional flags enable custom event helpers, cookie consent mode, and debug output.
Handles framework detection and generates the correct integration pattern automatically, avoiding the manual lookup and copy-paste errors that typically come with setting up gtag across different project types.
Quando usarla
- Adding GA4 to a Next.js app without manually writing gtag boilerplate
- Setting up page-view tracking in a SvelteKit or Astro site
- Adding cookie consent mode before launching to EU users
- Instrumenting form submissions and purchase events with typed helpers
- Configuring debug mode to verify tracking during development
Esempio di workflow
User asks: add analytics G-ABC1234567 --events --consent
- 1
Scans project files to detect framework (e.g., finds next.config.ts, identifies Next.js App Router)
- 2
Validates measurement ID format matches G-XXXXXXXXXX
- 3
Creates components/GoogleAnalytics.tsx with Script tags and injects it into app/layout.tsx
- 4
Creates lib/analytics-events.ts with typed event helpers (trackClick, trackPurchase, etc.)
- 5
Creates lib/analytics-consent.ts with consent mode defaults and updateConsent helpers
- 6
Adds NEXT_PUBLIC_GA_MEASUREMENT_ID to .env.local and .env.example, ensures .env.local is in .gitignore
GA4 tracking is live with consent mode defaulting to denied, event helpers exported and ready to use, and environment variable documented
Requisiti
- Google Analytics 4 property with a Measurement ID (format: G-XXXXXXXXXX), obtained from analytics.google.com
Installazione
clawhub install jeftekhari/add-analyticsEsegui il comando CLI oppure incolla il prompt in Claude Code, Cursor, Codex o nell'agente di coding che usi.