.claude/skills/insight-driven-event-tracking/SKILL.md
Transform raw data into actionable insights by shifting from tracking "what happened" to "why it happened." Use this skill when designing instrumentation specs for new features, auditing analytics dashboards that provide no clear direction, or diagnosing sudden drops in conversion.
npx skillsauth add samarv/Shanon insight-driven-event-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.
Most analytics efforts fail because they track "entertainment" (data that is interesting but doesn't change behavior) rather than "news" (information that forces a change in the real world). This framework shifts instrumentation from simple event logging to capturing the context necessary to explain user intent.
Before tracking, define the "physics" of your specific universe to identify where levers actually exist:
Instead of focusing solely on the conversion event (e.g., "Purchased"), focus on the step immediately preceding it. This is where the most friction exists.
A bad tracking spec has many unique event names with zero properties. A high-value spec has few events with many properties. For every core action, you must track the context:
For every event/property in your spec, ask: "If this number changes by 20%, what specific action will I take tomorrow?" If you don't have an answer, you are tracking entertainment, not news.
Example 1: Ride-Hailing Map Load
map_loaded.map_viewed
drivers_visible: 2 (Critical for understanding conversion)surge_multiplier: 1.5xestimated_pickup_time: 8 minsis_new_user: Truedrivers_visible < 3 have a 50% drop in conversion. Action: Re-route supply to those specific GPS coordinates.Example 2: Social App Onboarding
search_clicked.friend_search_performed
api_latency_ms: 1200msresults_count: 0search_query_length: 3api_latency_ms > 800ms. Action: Invest in search API optimization rather than changing the UI.When analyzing the resulting data, use these "Decacorn" benchmarks to evaluate health:
documentation
Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks
development
A framework to identify and develop sustainable competitive advantages (Power) based on a company's lifecycle stage. Use this when drafting a product strategy, evaluating business model durability, or distinguishing between "operational excellence" and true competitive moats.
development
```yaml --- name: podcast-launch-and-growth-engine description: A framework for launching and scaling a podcast based on topic validation, ranking momentum, and lean production. Use this skill when starting a new content channel, choosing a niche, or designing a listener acquisition strategy. --- This framework leverages Chris Hutchins' "All the Hacks" methodology to move from an idea to the top 5% of active podcasts through strategic validation, momentum-based launching, and high-efficiency di
development
A high-bar framework for measuring and achieving product-market fit (PMF) before scaling. Use this when validating a new product line, deciding if a beta is ready for a general release, or diagnosing why a product isn't generating organic word-of-mouth growth.