agentleFS
kwakseongjaekwakseongjae/oh-my-design/.agents/skills/google-analytics/SKILL.md

google-analytics

Skill588 starsChanged 34 days agoMITView on GitHub

Analyze Google Analytics data, review website performance metrics, identify traffic patterns, and suggest data-driven improvements. Use when the user asks about analytics, website metrics, traffic analysis, conversion rates, user behavior, or performance optimization.

  • Reads credentials
  • Installs packages

14 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use backlink-audit, search-console and 4 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • OpenClaudiaSkill

    backlink-audit

    Audit a domain's backlink profile using the SemRush API. Use when the user says "audit backlinks", "check my backlinks", "backlink analysis", "link profile", "toxic links", "disavow", "link building opportunities", "referring domains", "anchor text", or asks about a site's link authority.

    Also in 3 projects that use this

  • OpenClaudiaSkill

    search-console

    Pull Google Search Console data and perform search performance analysis. Use when asked about search rankings, clicks, impressions, CTR, index coverage, Core Web Vitals, or sitemap status. Trigger phrases: "search console", "GSC", "search performance", "clicks and impressions", "CTR analysis", "index coverage", "core web vitals", "URL inspection", "sitemap status", "ranking data", "search queries", "keyword positions".

    Also in 3 projects that use this

  • webrenewSkill

    google-ads

    Plan, build, audit or run Google Ads search campaigns for a local service business (plumber, dentist, roofer, cleaner, lawyer, clinic) on a small budget, with the agent drafting and the owner approving every change that spends money. Use this skill for a new Google Ads account or campaign, keyword research from customer questions, match types, negative keywords, location targeting, responsive search ads and assets, landing page message match, conversion tracking from GA4 or the Google Ads tag, budgets and bidding, Local Services Ads, a weekly check, and when the user says "PPC", "Google Ads is not working", "too expensive per lead", "wasted ad spend", "search terms" or "should we run Google ads".

    Also in 4 projects that use this

  • hoodiniSkill

    meta-ads

    Run Meta ads end to end like a PPC specialist: install and verify the pixel on a funnel, launch Sales campaigns, read the data, find where the funnel leaks, fix campaigns live, build stage-by-stage remarketing, and monitor daily. Pull, analyze, manage, and CREATE Meta ads (Facebook, Instagram, Messenger, Threads, Click-to-WhatsApp) via the Marketing API. Use when the user mentions Meta/FB/IG ads, Ads Manager, ROAS, CPA, CPM, CTR, ad spend, campaign or ad set performance, creative fatigue, frequency, CTWA, audience/placement breakdowns, A/B ad tests, or wants to pause an ad, change a budget, duplicate a winner, or launch a new campaign from scratch, install or debug a Meta pixel (פיקסל), set up remarketing (רימרקטינג, קהלים מותאמים, מי שביקר ולא קנה), or wants ongoing monitoring of a live campaign. Also covers reconciling ads with real sales from the checkout/course platform (Schooler MCP, סקולר, רב מסר) and turning past buyers, sign-ups that didn't pay and non-starters into cross-sell and recovery campaigns. Runs in Claude and in Grok Bot (גרוק בוט): install into a bot, run the daily check as a routine, alert on Telegram/WhatsApp. Trigger on Hebrew terms like פרסום בפייסבוק/באינסטגרם, פרסומות מטא, ביצועי קמפיין, פרסומות, צור קמפיין, השק קמפיין, A/B טסט. Trigger on questions like how are my ads doing, which creative is winning, is my ad fatigued, what's my CPA, drop a 30-day report, launch an A/B test for my course, build a campaign with these 3 angles. Trigger even if auth isn't set up - the skill walks through one-time setup. Do NOT use for organic Instagram analytics, Reels view counts on non-promoted posts, or organic Threads engagement; those need the Instagram Graph API.

    Also in 3 projects that use this

  • indranilbanerjeeSkill

    keyword-research

    Research keywords via the connected data source: intent, gaps. Grouping → keyword-cluster. \"what keywords should we target\"

    Also in 3 projects that use this

  • SentrySkill

    programmatic-seo

    When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pages," "[keyword] + [city] pages," "comparison pages," "integration pages," or "building many pages for SEO." For auditing existing SEO issues, see seo-audit.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 6 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask me questions like:

    line 51
  2. Distinctive:

    When you ask me to analyze Google Analytics data, I will:

    line 60
  3. Distinctive:

    Authentication Error: Verify that:

    line 121
  4. Distinctive:

    No Data Returned: Check that:

    line 126
  5. Very specific:

    Use environment variables or .env files for configuration

    line 140
  6. Very specific:

    Add .env and credential files to .gitignore

    line 141
  7. Distinctive:

    Use least-privilege access (Viewer role only)

    line 143
  8. Distinctive:

    All data is processed locally and used only to generate recommendations during the conversation.

    line 153

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Google Analytics Analysis

Analyze website performance using Google Analytics data to provide actionable insights and improvement recommendations.

Quick Start

1. Setup Authentication

This Skill requires Google Analytics API credentials. Set up environment variables:

export GOOGLE_ANALYTICS_PROPERTY_ID="your-property-id"
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"

Or create a .env file in your project root:

GOOGLE_ANALYTICS_PROPERTY_ID=123456789
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json

Never commit credentials to version control. The service account JSON file should be stored securely outside your repository.

2. Install Required Packages

# Option 1: Install from requirements file (recommended)
pip install -r cli-tool/components/skills/analytics/google-analytics/requirements.txt

# Option 2: Install individually
pip install google-analytics-data python-dotenv pandas

3. Analyze Your Project

Once configured, I can:

  • Review current traffic and user behavior metrics
  • Identify top-performing and underperforming pages
  • Analyze traffic sources and conversion funnels
  • Compare performance across time periods
  • Suggest data-driven improvements

How to Use

Ask me questions like:

  • "Review our Google Analytics performance for the last 30 days"
  • "What are our top traffic sources?"
  • "Which pages have the highest bounce rates?"
  • "Analyze user engagement and suggest improvements"
  • "Compare this month's performance to last month"

Analysis Workflow

When you ask me to analyze Google Analytics data, I will:

  1. Connect to the API using the helper script
  2. Fetch relevant metrics based on your question
  3. Analyze the data looking for:
    • Traffic trends and patterns
    • User behavior insights
    • Performance bottlenecks
    • Conversion opportunities
  4. Provide recommendations with:
    • Specific improvement suggestions
    • Priority level (high/medium/low)
    • Expected impact
    • Implementation guidance

Common Metrics

For detailed metric definitions and dimensions, see REFERENCE.md.

Traffic Metrics

  • Sessions, Users, New Users
  • Page views, Screens per Session
  • Average Session Duration

Engagement Metrics

  • Bounce Rate, Engagement Rate
  • Event Count, Conversions
  • Scroll Depth, Click-through Rate

Acquisition Metrics

  • Traffic Source/Medium
  • Campaign Performance
  • Channel Grouping

Conversion Metrics

  • Goal Completions
  • E-commerce Transactions
  • Conversion Rate by Source

Analysis Examples

For complete analysis patterns and use cases, see EXAMPLES.md.

Scripts

The Skill includes utility scripts for API interaction:

Fetch Current Performance

python scripts/ga_client.py --days 30 --metrics sessions,users,bounceRate

Analyze and Generate Report

python scripts/analyze.py --period last-30-days --compare previous-period

The scripts handle API authentication, data fetching, and basic analysis. I'll interpret the results and provide actionable recommendations.

Troubleshooting

Authentication Error: Verify that:

  • GOOGLE_APPLICATION_CREDENTIALS points to a valid service account JSON file
  • The service account has "Viewer" access to your GA4 property
  • GOOGLE_ANALYTICS_PROPERTY_ID matches your GA4 property ID (not the measurement ID)

No Data Returned: Check that:

  • The property ID is correct (find it in GA4 Admin > Property Settings)
  • The date range contains data
  • The service account has been granted access in GA4

Import Errors: Install required packages:

pip install google-analytics-data python-dotenv pandas

Security Notes

  • Never hardcode API credentials or property IDs in code
  • Store service account JSON files outside version control
  • Use environment variables or .env files for configuration
  • Add .env and credential files to .gitignore
  • Rotate service account keys periodically
  • Use least-privilege access (Viewer role only)

Data Privacy

This Skill accesses aggregated analytics data only. It does not:

  • Access personally identifiable information (PII)
  • Store analytics data persistently
  • Share data with external services
  • Modify your Google Analytics configuration

All data is processed locally and used only to generate recommendations during the conversation.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.