analytics-setup

Analytics Setup Generator

Generate a protocol-based analytics infrastructure that makes it easy to swap providers without changing app code.

When This Skill Activates

Use this skill when the user:

• Asks to "add analytics" or "set up analytics"
• Mentions "TelemetryDeck", "Firebase Analytics", "Mixpanel"
• Wants to "track events" or "add telemetry"
• Asks about "privacy-friendly analytics"
• Wants to swap analytics providers

Key Feature: Swappable Providers

The generated code uses a protocol-based architecture:

// Your app uses the protocol
analytics.track(.buttonTapped("subscribe"))

// Swap providers by changing ONE line:
let analytics: AnalyticsService = TelemetryDeckAnalytics() // or FirebaseAnalytics()

Pre-Generation Checks

1. Project Context Detection

• Check for existing analytics implementations
• Look for TelemetryDeck/Firebase/Mixpanel in Package.swift or Podfile
• Identify source file locations

2. Conflict Detection

Search for existing analytics:

Glob: **/*Analytics*.swift, **/*Telemetry*.swift
Grep: "protocol.*Analytics" or "TelemetryDeck" or "Firebase"

If found, ask user:

• Extend existing analytics?
• Replace with new implementation?
• Add new provider to existing setup?

Configuration Questions

Ask user via AskUserQuestion:

1. Which provider(s)?

   • TelemetryDeck (privacy-friendly, recommended)
   • Firebase Analytics
   • Mixpanel
   • None (NoOp for now, add later)

2. What events to track?

   • App lifecycle (launch, background, foreground)
   • Screen views
   • User actions (buttons, features used)
   • Errors
   • Custom events

3. User properties?

   • App version
   • Subscription status
   • Custom properties

Generation Process

Step 1: Create Core Files

Always generate these files:

1. AnalyticsService.swift - Protocol (never changes)
2. AnalyticsEvent.swift - Event definitions (app-specific)
3. NoOpAnalytics.swift - For testing/privacy mode

Step 2: Create Selected Provider(s)