Setup

On first use, read setup.md for integration guidelines. Create ~/mobile-app-analytics/ if it doesn't exist.

When to Use

User needs to track, analyze, or optimize mobile app performance metrics. Agent handles Firebase Analytics queries, App Store Connect data, Play Console reports, retention analysis, funnel debugging, and cohort comparisons.

Architecture

Memory lives in ~/mobile-app-analytics/. See memory-template.md for setup.

~/mobile-app-analytics/
├── memory.md          # Apps tracked, goals, alerts
├── apps/              # Per-app analytics configs
│   └── {app-name}.md  # Events, funnels, KPIs per app
└── benchmarks.md      # Industry benchmarks reference

Quick Reference

Core Rules

1. Platform Detection

Detect from context which platform(s) the app targets:

• iOS only → focus on App Store Connect + Firebase
• Android only → focus on Play Console + Firebase
• Cross-platform → cover both stores + unified Firebase

2. Metric Hierarchy

Always prioritize metrics in this order:

1. Revenue metrics (LTV, ARPU, conversion) — what pays the bills
2. Retention metrics (D1, D7, D30) — determines long-term success
3. Engagement metrics (DAU/MAU, session length) — leading indicators
4. Acquisition metrics (installs, sources) — growth levers

3. Cohort-First Analysis

Never report aggregate numbers alone. Always segment by:

• Install cohort (when users joined)
• Acquisition source (organic, paid, referral)
• User tier (free, trial, paid)
• Platform (iOS vs Android)

4. Alert Thresholds

Proactively flag anomalies:

5. Data Freshness

Know platform data delays:

6. Privacy Compliance

• Never track PII in custom events
• Respect ATT (iOS) and consent requirements
• User properties: demographics OK, personal identifiers NOT OK
• GDPR: support data deletion requests

7. Event Naming Conventions

Enforce consistent naming across platforms:

{verb}_{noun}[_{qualifier}]

Examples:
- view_screen_home
- tap_button_subscribe  
- complete_purchase_annual
- start_onboarding_step1

Common Traps

• Vanity metrics obsession → Total downloads means nothing; track active users and retention instead
• Ignoring platform differences → iOS users often have 20-30% higher LTV; don't merge data blindly
• Wrong attribution window → 7-day attribution misses subscription conversions; use 30-day for subscriptions
• Survivorship bias → Analyzing only current users ignores why churned users left
• Timezone mismatches → Firebase uses UTC by default; App Store uses your configured timezone

External Endpoints

No other data is sent externally.

Security & Privacy

Data that leaves your machine:

• Analytics queries to Firebase/Apple/Google APIs when you provide credentials

Data that stays local:

• Your tracked apps and goals in ~/mobile-app-analytics/
• Benchmark comparisons and notes

This skill does NOT:

• Store credentials (use your platform's standard credential methods)
• Access files outside ~/mobile-app-analytics/
• Make requests to undeclared endpoints

Scope

This skill ONLY:

• Provides guidance on mobile app analytics platforms
• Stores your app configurations in ~/mobile-app-analytics/
• Queries Firebase, App Store Connect, and Play Console when you provide credentials

This skill NEVER:

• Stores credentials in files (use environment variables)
• Accesses files outside ~/mobile-app-analytics/
• Makes requests to undeclared endpoints
• Modifies global agent memory or other skills

Related Skills

Install with clawhub install <slug> if user confirms:

• app-store-connect — iOS App Store management
• flutter — Cross-platform app development
• saas — SaaS business metrics and growth

Feedback

• If useful: clawhub star mobile-app-analytics
• Stay updated: clawhub sync