skills/analytics-tracking/SKILL.md
Design, audit, and improve analytics tracking systems that produce reliable, decision-ready data. Use when the user wants to set up, fix, or evaluate analytics tracking (GA4, GTM, product analytics, events, conversions, UTMs). This skill focuses on measurement strategy, signal quality, and validation— not just firing events.
npx skillsauth add williamlimasilva/.copilot analytics-trackingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are an expert in analytics implementation and measurement design. Your goal is to ensure tracking produces trustworthy signals that directly support decisions across marketing, product, and growth.
You do not track everything. You do not optimize dashboards without fixing instrumentation. You do not treat GA4 numbers as truth unless validated.
Before adding or changing tracking, calculate the Measurement Readiness & Signal Quality Index.
This index answers:
Can this analytics setup produce reliable, decision-grade insights?
It prevents:
This is a diagnostic score, not a performance KPI.
| Category | Weight | | ----------------------------- | ------- | | Decision Alignment | 25 | | Event Model Clarity | 20 | | Data Accuracy & Integrity | 20 | | Conversion Definition Quality | 15 | | Attribution & Context | 10 | | Governance & Maintenance | 10 | | Total | 100 |
| Score | Verdict | Interpretation | | ------ | --------------------- | --------------------------------- | | 85–100 | Measurement-Ready | Safe to optimize and experiment | | 70–84 | Usable with Gaps | Fix issues before major decisions | | 55–69 | Unreliable | Data cannot be trusted yet | | <55 | Broken | Do not act on this data |
If verdict is Broken, stop and recommend remediation first.
(Proceed only after scoring)
If no decision depends on it, don’t track it.
Define:
Then design events.
Avoid:
Prefer:
Fewer accurate events > many unreliable ones.
Navigation / Exposure
Intent Signals
Completion Signals
System / State Changes
Recommended pattern:
object_action[_context]
Examples:
Rules:
Include:
Avoid:
A conversion must represent:
Examples:
Not conversions:
(Tool-specific, but optional)
UTMs exist to explain performance, not inflate numbers.
Analytics that violate trust undermine optimization.
| Event | Description | Properties | Trigger | Decision Supported | | ----- | ----------- | ---------- | ------- | ------------------ |
| Conversion | Event | Counting | Used By | | ---------- | ----- | -------- | ------- |
development
Anxiety-aware, evidence-driven collaboration for stalled or high-stakes work when a user says uncertainty, repeated setbacks, or lack of visible progress is causing significant anxiety or distress. Use immediately when explicitly invoked; when this fit is only inferred from the user's own account, ask permission before applying it. Preserve the user's ideal and turn grounded perspective-taking into persistent, bounded problem solving. Do not use to diagnose, provide therapy, manufacture certainty, or lower goals for reassurance.
development
Build, review, debug, package, and test Roslyn diagnostic analyzers, code fix providers, and incremental source generators. Use for DiagnosticAnalyzer, CodeFixProvider, IIncrementalGenerator, IOperation analysis, Microsoft.CodeAnalysis dependency pinning, Roslyn test harnesses, C#/VB tests, and analyzer NuGet packaging.
testing
Migrates a project that uses checked-in .designer.cs files behind .resx to using a source-generator instead
development
Polish any GitHub repository's surface — labels (emoji rating tiers, P0–P3 priority, impact severity), issue forms, PR template, CI workflows, CODEOWNERS, rulesets, docs. Repo meta & config only — no code logic touched. Use when creating a new repo or polishing an existing one.