taxonomy

Audit and govern Amplitude event taxonomies with naming standards, scoring, and safe metadata operations.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/amplitude/amplitude-copilot-plugin --skill taxonomy-amplitude
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: taxonomy
Source: https://github.com/amplitude/amplitude-copilot-plugin/tree/main/skills/plugins/amplitude/taxonomy
Command: npx skills add https://github.com/amplitude/amplitude-copilot-plugin --skill taxonomy-amplitude

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Amplitude taxonomies drift over time: duplicate events, cryptic names, missing descriptions, stale events, and quota pressure make analytics unreliable and degrade AI feature accuracy. This Skill provides a single source of truth for auditing, scoring, and improving event tracking plans without risking destructive changes. ## Core Features & Use Cases - Taxonomy Auditing: Detect duplicates, stale events, test artifacts, unexpected events, and naming convention outliers using defined signals, thresholds, and a health scoring framework. - Naming & Property Standards: Enforce Title Case event names, snake_case properties, type standards, and category assignment when generating or reviewing tracking plans. - Safe Governance: Apply metadata-only improvements (descriptions, display names, categories, tags) with before/after confirmation, and guide phased deprecation without blocking, deleting, or sampling. - Use Case: Ask the assistant to audit your Amplitude taxonomy; it paginates through all events, scores issues by impact and importance, and presents a prioritized cleanup plan for your approval. ## Quick Start Audit my Amplitude event taxonomy and recommend the highest-impact improvements.

Frequently Asked Questions about taxonomy

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

FAQPage Schema
How do I audit my Amplitude event taxonomy for data quality issues?

Run a taxonomy audit that paginates through all events and properties, checking for duplicates, stale events, missing descriptions, and naming outliers. Findings are scored by impact, event importance, and effort, then presented as a prioritized action plan.

What naming convention should I use for Amplitude events and properties?

Use Title Case with the pattern Object + Past-Tense Verb for events, such as Song Played or Form Submitted. Use snake_case for properties with descriptive names like payment_type, and include units when ambiguous, such as video_duration_seconds.

Does blocking or hiding an event reduce my Amplitude taxonomy type count?

No. Blocking and hiding do not reduce type counts; only deleting an event or property type reduces the count. Blocking reduces event volume for billing purposes, while hiding only affects visibility in the taxonomy.

Can this skill delete or block events in Amplitude automatically?

No. It only performs metadata-only operations such as updating descriptions, display names, categories, and tags, always with explicit user confirmation. Blocking, deleting, merging, and sampling are outside its authority and require phased human-led deprecation.

Why do unexpected events in Amplitude reject metadata updates?

Events with Unexpected status receive data but are not in the tracking plan, so Amplitude blocks metadata edits. Add the event to the tracking plan first if it is legitimate, or treat it as a deprecation candidate if it appears to be test or invalid traffic.

How does taxonomy quality affect Amplitude AI features?

AI features select events by evaluating the visible taxonomy, so cryptic names, missing descriptions, and duplicate clusters cause wrong event selection. Writing behavior-focused descriptions and cleaning up deprecated events directly improves AI output accuracy.