analytics-amplitude

Query Amplitude event segmentation, user activity streams, and chart annotations via API scripts.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill analytics-amplitude-erwinv2k-tkg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analytics-amplitude
Source: https://github.com/erwinv2k-TKG/AgentesVSC/tree/main/packs/incidentfox/sre-agent/.claude/skills/analytics-amplitude
Command: npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill analytics-amplitude-erwinv2k-tkg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve? Investigating product usage trends, error spikes, or individual user issues in Amplitude normally requires manual dashboard navigation; this Skill lets you run those queries directly from the command line during incident or product analysis. ## Core Features & Use Cases - Event Segmentation Queries: Count uniques, totals, averages, or percent of DAU for any tracked event over a date range, with grouping and property filters. - User Activity Lookup: Retrieve a specific user's full event stream by user ID or email to debug user-reported issues. - Chart Annotations: List deploy markers and release annotations to correlate metric changes with releases. - Use Case: An error spike is reported. Run query_events.py with daily intervals to see the trend, group by user_id to find affected users, trace one user's activity stream, then check annotations to see if a deploy caused it. ## Quick Start Ask the agent to query Amplitude for daily unique counts of the "Error Occurred" event over the past week and check whether any deploy annotations correlate with the spike.

Frequently Asked Questions about analytics-amplitude

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

FAQPage Schema
How do I query Amplitude event segmentation from the command line?

Run query_events.py with --event, --start, and --end arguments to get event counts over a date range. Add --group-by to segment by a property, --metric for uniques/totals/avg/pct_dau, and --interval for daily, weekly, or monthly buckets.

How to look up a specific user's activity in Amplitude?

Use get_user_activity.py with the --user flag, passing either an Amplitude user ID or an email address. It returns the user's event stream with timestamps, platform, location, and event properties, with --offset and --limit for pagination.

Does the Amplitude API support EU region endpoints?

Yes, set the AMPLITUDE_REGION environment variable to EU to route requests to analytics.eu.amplitude.com instead of the default US endpoint. The client maps the region value to the correct base URL automatically.

Why are my Amplitude API credentials not visible in environment variables?

Credentials are injected transparently by a proxy layer, so AMPLITUDE_API_KEY and AMPLITUDE_SECRET_KEY will not appear in your environment. Run the scripts directly; authentication is handled through the proxy or a sandbox JWT.

What are the limitations of Amplitude event segmentation queries?

Event names are case-sensitive and must match exactly as tracked. Hourly intervals are not available on all Amplitude plans, and date ranges must be provided in YYYYMMDD or YYYY-MM-DD format.