analytics-amplitude

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

656|82|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/incidentfox/incidentfox --skill analytics-amplitude
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analytics-amplitude
Source: https://github.com/incidentfox/incidentfox/tree/main/sre-agent/.claude/skills/analytics-amplitude
Command: npx skills add https://github.com/incidentfox/incidentfox --skill analytics-amplitude

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Investigating product incidents and usage questions requires manually navigating the Amplitude dashboard, which slows down debugging when you need event trends, affected users, or deploy correlations quickly.

Core Features & Use Cases

  • Event Segmentation Queries: Count uniques, totals, or averages for any tracked event over a date range, with grouping by properties like platform and JSON-based 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 error spikes with releases.
  • Use Case: When an error spike is reported, query the "Error Occurred" event with daily intervals to see the trend, group by user_id to find impacted users, trace one user's activity stream, then check annotations for a correlating deploy.

Quick Start

Ask the agent to query Amplitude for the daily count of unique users who triggered the "Error Occurred" event over the past week, grouped by platform.

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 data 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, and --interval for daily, weekly, or monthly granularity.

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

Use get_user_activity.py with the --user argument set to an Amplitude user ID or 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 is my Amplitude event query returning no data?

Event names are case-sensitive and must match exactly as tracked in Amplitude, so verify the spelling first. Also confirm the date range uses YYYYMMDD or YYYY-MM-DD format and that the event actually fired during that period.

What are the limitations of Amplitude segmentation intervals?

Hourly intervals are not available on all Amplitude plans, so daily, weekly, monthly, or realtime intervals are the reliable options. Realtime is the default when no interval is specified.