analytics-setup_skill

Overview

This skill generates a protocol-based analytics infrastructure for Swift apps, enabling easy swapping between providers like TelemetryDeck, Firebase, and Mixpanel. It scaffolds core protocol files, provider implementations, and SwiftUI environment integration so tracking calls remain stable across provider changes. Use it to add telemetry, track events, and support privacy-friendly or test-friendly analytics modes.

How this skill works

The generator creates a stable AnalyticsService protocol and an AnalyticsEvent enum to centralize event definitions. It then adds provider-specific implementations (TelemetryDeckAnalytics, FirebaseAnalytics, MixpanelAnalytics) plus a NoOpAnalytics for testing or privacy modes. For SwiftUI projects it also produces an EnvironmentKey to inject the chosen analytics service into views, and it suggests where to place files based on common project layouts.

When to use it

• When adding analytics to a Swift app for the first time
• When you want to swap telemetry providers without changing app code
• When you need privacy-friendly or testable (NoOp) analytics
• When tracking events, screen views, lifecycle events, or errors
• When preparing provider-specific configuration (e.g., Firebase plist)

Best practices

• Keep AnalyticsService and AnalyticsEvent stable; add new events to AnalyticsEvent only
• Prefer TelemetryDeck for privacy-focused deployments and NoOpAnalytics for tests and previews
• Register provider once in App init and inject via SwiftUI environment or DI container
• Store provider credentials and config outside source (Secrets, plist) and avoid hardcoding
• Track high-level, product-relevant events and include contextual properties for analysis

Example use cases

• Scaffold TelemetryDeckAnalytics to enable privacy-first telemetry with minimal code changes
• Add FirebaseAnalytics implementation and the required GoogleService-Info.plist for full feature tracking
• Create NoOpAnalytics for unit tests and SwiftUI previews to avoid external dependencies
• Swap providers by changing one line in App.swift to move from TelemetryDeck to Mixpanel
• Generate AnalyticsEvent entries for app lifecycle, screen views, button taps, and error reporting