audit-analytics

Audit analytics instrumentation for event naming, schema consistency, and PII leaks.

22|3|Updated Jul 28, 2024
One-click install
npx skills add https://github.com/webdevcody/go-mailing-list --skill audit-analytics-webdevcody
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-analytics
Source: https://github.com/webdevcody/go-mailing-list/tree/main/.claude/skills/audit-analytics
Command: npx skills add https://github.com/webdevcody/go-mailing-list --skill audit-analytics-webdevcody

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents silent under-tracking and taxonomy drift by checking that important user actions emit the correct analytics events consistently, without accidentally shipping sensitive data.

Core Features & Use Cases

  • SDK detection and event catalog alignment: Detects the analytics SDK in the codebase and uses any existing event catalog as the naming convention source.
  • Per-surface event coverage auditing: Scans a specific route/feature surface to identify missing, misclassified, or inconsistently tracked actions (page views, form submits, CTA clicks, destructive actions, errors).
  • Drift and privacy risk checks: Flags naming/property drift (case, tense, prefixes, property shape/types) and highlights PII or secrets exposure in event properties.

Quick Start

Audit your application’s analytics by asking the AI to review one route for missing tracking, event taxonomy drift, and any PII or secret fields in analytics properties.

Frequently Asked Questions about audit-analytics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit analytics instrumentation for missing events on a specific route?

To audit analytics instrumentation, you scan a specific route or feature surface to enumerate user actions and report missing-event gaps. This verifies that page views, form submits, and CTA clicks emit correctly named events consistently.

What is analytics event taxonomy drift and how do I detect it?

Analytics event taxonomy drift occurs when tracked events deviate from naming conventions or property schemas. You detect drift by validating event names against your project's event catalog, checking for inconsistencies in case, tense, prefixes, and property shape.

How do I detect PII or secrets leaking into analytics event properties?

To detect PII or secrets leaking into analytics event properties, scan tracked events to flag any email-like, name-like, or secret-like properties. This prevents accidentally shipping sensitive user data to your analytics platform.

Can I audit analytics SDK detection without an existing event catalog?

Yes, you can audit analytics without an existing event catalog. The process detects the installed analytics SDK in your codebase and uses any available catalog as an optional naming convention source to validate tracked actions.

What's the best way to verify untracked user actions in a feature module?

The best way to verify untracked user actions is enumerating action sites within a feature module's scope. This identifies destructive actions and errors that lack tracking, ensuring all important user behavior emits correctly shaped events.

Why does my analytics event tracking have inconsistent property schemas?

Inconsistent analytics event property schemas result from taxonomy drift across different developers or features. Auditing your instrumentation validates property shape and types against your event catalog to highlight these schema inconsistencies.