Agent skill · supabase
telemetry-standards
PostHog event tracking standards for Supabase Studio. Use when adding
What it needs
About 4k tokens when loaded.
What this skill does
Telemetry Standards for Supabase Studio Standards for PostHog event tracking in apps/studio/. Apply these when reviewing PRs that touch tracking or when implementing new tracking. Event Naming Format: [object][verb] in snakecase Approved verbs only (canonical list — derived from packages/common/telemetry-constants.ts): opened, clicked, submitted, created, removed, updated, intended, evaluated, added, enabled, disabled, copied, exposed, failed, converted, closed, completed, applied, sent, moved Flag these: Unapproved verbs (saved, viewed, seen, pressed, etc.) Wrong order: clickproductcard → should be productcardclicked Wrong casing: productCardClicked → should be productcardclicked Good examples: productcardclicked backupbuttonclicked sqlquerysubmitted Common mistakes with corrections: databasesaved → savebuttonclicked or databaseupdated (unapproved verb) clickbackupbutton → backupbuttonclicked (wrong order) dashboardViewed → don't track passive views on page load componentrendered → don't track — no user interaction Property Standards Casing: camelCase preferred for new events. The codebase has existing snakecase properties (e.g., schemaname, tablename) — when adding properties to an existing event, match its established convention. Names must be self-explanatory: { productType: 'database', planTier: 'pro' } { assistantType: 'sql', suggestionType: 'optimization' } Flag these: Generic names: label, value, name, data PascalCase properties Inconsistent names across similar events (e.g., assistantType in one event, aiType in a related event) Mixing camelCase and snakecase within the same event What NOT to Track Passive views/renders on page load (dashboardviewed, sidebarappeared, pageloaded) Component appearances without user interaction Generic "viewed" or "seen" events — already captured by pageview events DO track: user clicks, form submissions, explicit opens/closes, user-initiated actions. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills supabase/telemetry-standards--d5203b