flutter-product-analytics
Design, implement, repair, or review product analytics in Flutter using event contracts, identity, consent, funnels, attribution, experiment exposure, delivery semantics, and backend verification. Use for measuring user behavior and business outcomes; not operational logs, crash reporting, profiling, or general UI tracking.
How do I install this agent skill?
npx skills add https://github.com/thienqo/flutter-skills --skill flutter-product-analyticsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a well-structured set of guidelines for implementing product analytics in Flutter. It focuses on best practices, privacy, and deterministic testing without containing any malicious patterns or technical vulnerabilities.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Flutter Product Analytics
Instrument decisions, not widgets. Begin with a product question and a stable event contract, then preserve the project's analytics provider, consent platform, state management, navigation, and data architecture unless migration is requested.
Do not add a vendor, create dashboards, enable collection, or change live retention and consent configuration merely because the skill is selected.
Preflight
Read pubspec.yaml, SDK constraints, current analytics adapters and initialization, environments, consent and privacy controls, event definitions, identity lifecycle, navigation tracking, offline buffering, backend transformations, tests, dashboards or schemas in scope, and release configuration. Identify the question, decision, owner, population, and success definition before adding an event.
Each event needs a semantic trigger, stable name, bounded typed properties, identity and consent policy, delivery expectation, and verification plan. Emit once for the domain occurrence—not from widget build, incidental rebuilds, route observers, and button callbacks simultaneously.
When proposing or repairing an event, state the contract instead of asking or deferring to the adapter: which identity is attached (anonymous or authenticated, and what happens on login or account switch), whether consent off drops or queues the event, the delivery semantics (for example at-least-once with a dedupe key), and the rule for retries and process restarts. Where the project does not say, choose the conservative default, label it an assumption, and name who can change it.
Load references conditionally
- Read event contracts and ownership when defining names, properties, semantic triggers, funnels, revenue events, schema evolution, or duplicate prevention.
- Read identity, consent, and privacy for anonymous and authenticated identity, account switching, opt-in or opt-out, deletion, sensitive data, advertising attribution, and offline buffering.
- Read verification and experiments for DebugView or live-debug tools, backend inspection, environments, funnel validation, experiment exposure, and rollout evidence.
Boundaries
flutter-observabilityowns operational errors, logs, traces, release context, and incident diagnosis. Product analytics owns user behavior, funnels, attribution, conversion, and experiments.flutter-in-app-purchasesowns verified transactions and entitlements; analytics may observe their outcomes but never grants access or defines purchase truth.flutter-navigationowns route correctness; analytics maps meaningful screen or journey semantics without coupling navigation to a vendor.flutter-authenticationowns session state; analytics follows its explicit identity and account lifecycle.flutter-persistenceowns storage mechanics; this skill defines consent-aware bounded buffering and event deletion requirements.flutter-securityowns broad privacy and threat review.
Verification
Test the provider-neutral adapter and semantic producers deterministically. Cover exact-once emission, property validation, consent transitions, anonymous-to-authenticated identity, logout and account switch, offline queue bounds, retry duplicates, environment separation, and provider failure.
Use an authorized non-production analytics project or debug surface to confirm the event arrives once with the expected name, properties, identity, timestamp, consent state, and environment. Verify the downstream schema, funnel, or experiment consumer when it is part of the task. A successful SDK call or console log is not end-to-end analytics evidence.
When authorized provider or dashboard access is unavailable, explicitly record provider ingestion and each downstream dashboard, funnel, or experiment boundary as unverified because it was not observed. Do not collapse that evidence gap into a generic “pending” status.
Sources
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/thienqo/flutter-skills/flutter-product-analytics">View flutter-product-analytics on skillZs</a>