ga-deep-dive

What This Skill Does

The ga-deep-dive skill is the ultimate diagnostic suite for Google Analytics 4 (GA4). It transforms raw data into an actionable Owner's War Room, providing deep visibility into your product's performance. By automating complex API queries, it delivers everything from high-level health scores—such as engagement, traffic diversity, and retention rates—to granular insights like scroll depth, site search behavior, and cohort retention. Whether you are an executive needing a summary or a data analyst hunting for friction points, this skill extracts the full potential of the GA4 API.

Installation

Installation is streamlined via the ClawHub CLI. First, execute clawhub install openclaw/skills/skills/fcavalcantirj/ga-deep-dive. Navigate to the directory, set up a virtual environment, and install dependencies via pip install -r requirements.txt. You must then configure Google Cloud OAuth credentials by creating a project in the Google Cloud Console, enabling the GA4 Data API, and saving your OAuth client secret to ~/.config/ga-deep-dive/credentials.json. Finally, obtain your 9-digit GA4 Property ID from the Google Analytics Admin panel and run the initial script to complete the browser-based OAuth consent flow.

Use Cases

This skill is perfect for identifying underperforming content, optimizing user acquisition channels, and monitoring long-term product health. Use it to generate bi-weekly executive summaries, audit mobile vs. desktop experience, analyze how far users read your documentation or articles, and evaluate the effectiveness of custom audiences. It is an essential tool for data-driven product growth.

Example Prompts

1. "Help me set up the ga-deep-dive skill for my website."
2. "Run a full v4 deep dive analysis on my primary property for the last 30 days."
3. "Generate a bi-weekly health report and email it to my marketing team."

Tips & Limitations

Always ensure your Google Cloud project is properly linked to the GA4 property you intend to query. While the skill is powerful, it is limited by the data available within your specific GA4 view; custom dimensions and events must be configured in GA4 first for them to appear in the reports. For security, keep your credentials.json file protected and avoid hardcoding sensitive API keys; use environment variables whenever possible for email integration.