add-analytics
por jeftekhari
Data & AnalyticsResumo
Add Google Analytics 4 tracking to any project.
Descrição
O que esta skill faz
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 usá-la
- 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
Exemplo de fluxo de trabalho
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
Requisitos
- Google Analytics 4 property with a Measurement ID (format: G-XXXXXXXXXX), obtained from analytics.google.com
Instalação
clawhub install jeftekhari/add-analyticsExecute o comando da CLI ou cole o prompt no Claude Code, Cursor, Codex ou no agente de código que você usa.