instrument-tracking
Installation
SKILL.md
Instrument tracking on a createFlow app
Read the project's flows, map each node to the Waniwani event taxonomy, insert the tracking calls with metadata sourced from flow state, and verify. The output is a flow where every funnel stage emits exactly the right event, without the user writing a single track call.
Hosted reference: docs.waniwani.ai/sdk/tracking/instrumentation
The taxonomy (closed set)
Events are typed and first-class. Never invent a custom event name; model every funnel step with one of these.
| Event | Helper | When it fires | Required data |
|---|---|---|---|
tool.called |
automatic via withWaniwani(server) |
Every tool invocation | none |
lead_qualified |
waniwani?.track.leadQualified({ externalId?, email?, name? }) |
The conversation produced a concrete handoff to your business | identity only |
price_shown |
waniwani?.track.priceShown({ amount, currency, itemId?, label? }) |
You showed one price | amount, currency |
prices_compared |
waniwani?.track.pricesCompared({ options: [{ id, amount, currency }] }) |
You showed 2+ options side by side | options[] |
option_selected |
waniwani?.track.optionSelected({ id, amount, currency }) |
The user picked one option | id, amount, currency |
converted |
waniwani?.track.converted({ amount, currency, occurredAt? }) |
The user became paying | amount, currency |
| identity | waniwani?.identify(userId, properties?) |
A stable external id becomes known | userId |