Ira Bodnar··Updated ·12 min read

Claude Skills for Amplitude: 10 SKILL.md Files + Copy-Paste Prompts

Quick answer: Save each recurring Amplitude question as a Claude skill that names the report to read and the output you want. Ryze AI is the best read-only connector for running these skills on live Amplitude data, with one caveat: it connects one Amplitude project per workspace.

Below: 10 SKILL.md files, the Amplitude endpoint each one reads, install steps and quick prompts.

Ryze AI · Paid Ads

Amplitude skills on live data

  • 7-day free trial, $89 a month flat

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 10 Claude skills for Amplitude at a glance

All 10 skills only read. The Ryze AI Amplitude tool sends GET requests, so no skill can edit a chart, cohort or event.

  1. 01Weekly product digestActive users, sessions and top events, week over week

    Amplitude report it reads: Active and new users, average sessions, events list

    Access: Read

  2. 02Saved chart readoutTurn a saved chart into a short summary

    Amplitude report it reads: Chart results by chart ID

    Access: Read

  3. 03Event segmentationOne event split by up to 2 properties

    Amplitude report it reads: Event segmentation

    Access: Read

  4. 04Signup funnelWhere users drop between steps

    Amplitude report it reads: Funnel analysis

    Access: Read

  5. 05Retention checkWhich users come back

    Amplitude report it reads: Retention

    Access: Read

  6. 06Growth snapshotNew against active users over time

    Amplitude report it reads: Active and new users

    Access: Read

  7. 07Session healthSession length and sessions per user

    Amplitude report it reads: Average sessions, sessions per user

    Access: Read

  8. 08Realtime checkConfirm tracking after a release

    Amplitude report it reads: Realtime active users

    Access: Read

  9. 09User lookupFind a user and read their recent events

    Amplitude report it reads: User search, user activity

    Access: Read

  10. 10Cohort and annotation reviewList cohorts and the release notes on the timeline

    Amplitude report it reads: Cohorts, annotations

    Access: Read

Endpoint names come from Amplitude's Dashboard REST API reference, listed in Sources. Amplitude was not connected to a test workspace when this page was written, so run each skill once on your project and compare the first answer with the same chart in Amplitude.

What are Claude skills for Amplitude?

A Claude skill for Amplitude is a saved SKILL.md file that says which Amplitude report to read and how to present it. Per Anthropic's Agent Skills docs, the file opens with a name and a description, and Claude reads the body only when a request matches the description.

A name takes up to 64 lowercase letters, numbers and hyphens and cannot include the reserved words claude or anthropic, so every skill here starts with amplitude. A description takes up to 1,024 characters and states what the skill does and when to use it.

  1. What it is

    One-off prompt
    A question typed in chat
    Skill
    A saved file with a fixed report and output
    Amplitude connection
    The tool Claude uses to reach your project
  2. Setup

    One-off prompt
    None
    Skill
    Save once per Claude app
    Amplitude connection
    API key, secret key and data residency
  3. Same shape each run

    One-off prompt
    No
    Skill
    Yes
    Amplitude connection
    Depends on the prompt or skill

The skills read Amplitude's Dashboard REST API, which returns the same numbers as the charts in the Amplitude app for the same dates and filters. Dates are sent as YYYYMMDD and event filters as JSON, so each skill below states the window it uses.

How to install the skills in Claude Code and claude.ai

Claude Code

Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md inside a repo to share it with the team. Claude picks a skill when a request matches it, or you type /amplitude-weekly-digest (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists custom skill uploads on Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the data

The Amplitude MCP page covers the Amplitude tool on the Ryze AI connector. The live data section below has the 4 setup steps.

Custom skills do not sync between surfaces: a skill uploaded to claude.ai is missing in Claude Code, and the reverse. Anthropic advises using skills only from trusted sources, so read each file before saving it. Skills for other analytics tools are on Claude skills for PostHog and Claude skills for Google Analytics.

Reporting skills: weekly numbers and saved charts

These three answer the questions you get every Monday. Each one states a date window, because Amplitude prices a request by the number of days it covers.

01. Weekly product digest

Compares the last 7 complete days with the 7 before for active users, new users, average sessions and the events with the most uniques.

SKILL.md
--- name: amplitude-weekly-digest description: Weekly Amplitude recap of active users, new users, sessions and top events, last 7 days against the 7 days before. Use for weekly product summaries. --- # Amplitude weekly digest Use amplitude__read for each report, read-only: 1. Active and new users, daily interval, last 14 complete days. 2. Average sessions per day, same window. 3. The events list, for the events with the most uniques this week. Output: - One table: metric, last 7 days, previous 7 days, change in percent. - Three bullets on the biggest movers, with the dates they moved. - A line stating the date window and the project. Do not guess a cause. If a drop starts on one date, say so and stop.

Use it when: you send a Monday update and want the same table every week.

02. Saved chart readout

Reads the results of a chart you already built, by chart ID, and writes the summary you would otherwise type under the chart.

SKILL.md
--- name: amplitude-chart-readout description: Reads a saved Amplitude chart by chart ID and summarizes its trend and outliers. Use when the user shares a chart ID or a chart link. --- # Amplitude saved chart readout 1. Take the chart ID from the user. It is the last part of the chart URL in Amplitude. 2. Call amplitude__read for the saved chart results by chart ID. 3. Report: what the chart measures, the first and last value, the highest and lowest point with dates, and any series that moves against the rest. 4. If the chart ID is not found, say so and ask the user to check the ID. Do not substitute another chart.

Use it when: your team already trusts a chart and only needs the written takeaway.

03. Event segmentation

Splits one event by up to 2 properties, such as platform and country, and ranks the groups.

SKILL.md
--- name: amplitude-event-segmentation description: Splits one Amplitude event by up to 2 properties and ranks the groups. Use when asked how an event differs by platform, country, plan or source. --- # Amplitude event segmentation Ask the user for the event name, the metric (uniques, totals, share of daily active users or average) and up to 2 group-by properties. Call amplitude__read for event segmentation, last 28 days, daily interval. Keep the window as short as the question allows: Amplitude cost grows with days and with each group-by. Output: a ranked table of groups with the metric, the share of the total, and the trend from the first to the last week. If the user names a third property, run a second request instead.

Use it when: a headline number moves and you need to know which segment moved it.

Behavior skills: funnels, retention and growth

These four read what users do over time. They are the heaviest requests on this page, so keep the date window as short as the decision allows.

04. Signup funnel

Reads a funnel for 2 to 5 events and names the step with the largest drop. Amplitude offers ordered, unordered and sequential modes and a conversion window, so state which one you want (funnel docs).

SKILL.md
--- name: amplitude-signup-funnel description: Reads an Amplitude funnel for 2 to 5 events and names the step with the largest drop. Use when asked where users leave between landing and signup. --- # Amplitude signup funnel Ask for the step events in order, the mode (ordered, unordered or sequential) and the conversion window in days. Call amplitude__read for funnel analysis, last 28 days. Output: - A table: step, users, conversion from the previous step, conversion from step 1. - The step with the largest relative drop. - The mode and the window used, so the numbers can be repeated. Do not compare two funnels that used different modes.

Use it when: you plan a signup or onboarding change and want a baseline.

05. Retention check

Reads retention for a starting event and a returning event and states how many users come back on each day or week.

SKILL.md
--- name: amplitude-retention-check description: Reads Amplitude retention for a starting event and a returning event. Use when asked whether new users come back. --- # Amplitude retention check Ask for the starting event, the returning event and the retention type (n-day, rolling or bracket). Call amplitude__read for retention, last 30 days, weekly interval. Retention is a costly report in Amplitude, so run it once and reuse the result. Output: a table of cohort start date, users, and the share returning in each period; then one sentence on where the curve flattens. Say which retention type was used.

Use it when: you review a release and need to know whether it changed who returns.

06. Growth snapshot

Puts new users and active users on one timeline and flags the weeks where new users rise but active users do not.

SKILL.md
--- name: amplitude-growth-snapshot description: Compares new and active users in Amplitude over a period. Use when asked whether user growth is real or only a spike in signups. --- # Amplitude growth snapshot Call amplitude__read twice for active and new users: once with the new-users metric and once with the active-users metric, weekly interval, last 12 weeks. Output: - A table by week: new users, active users, ratio of new to active. - The weeks where new users rose and active users stayed flat or fell. - The dates of the first and last week, so the result can be repeated.

Use it when: a campaign brought signups and you want to see whether activity followed.

07. Session health

Reads average session length and sessions per user for two periods and states the change.

SKILL.md
--- name: amplitude-session-health description: Compares Amplitude average session length and sessions per user across two periods. Use when asked whether engagement changed. --- # Amplitude session health Call amplitude__read for average sessions and for sessions per user, last 28 days against the 28 days before. Output: two numbers per period (average session length, sessions per user), the change for each, and one line on whether they moved in the same direction. If session data is empty, say that session tracking may be off in the project and stop.

Use it when: you review engagement after a product change.

Checking skills: realtime, users and cohorts

These three answer point questions: did tracking come back, what did one user do, and what is already defined in the project. Amplitude limits user lookups separately, so use them one at a time.

08. Realtime check

Confirms that events arrive right now. Amplitude's realtime report covers the last 2 days at 5-minute steps.

SKILL.md
--- name: amplitude-realtime-check description: Reads Amplitude realtime active users to confirm tracking after a release. Use when asked whether events are still arriving. --- # Amplitude realtime check Call amplitude__read for realtime active users. Output: the latest 5-minute value, the highest value in the last 2 days with its time, and whether the last hour is flat at zero. A flat zero means events are not arriving. Say that tracking needs a check and stop. Do not guess a cause.

Use it when: you just shipped and want a quick yes or no on tracking.

09. User lookup

Finds a user by user ID, device ID or Amplitude ID and lists their recent events. Treat the output as personal data.

SKILL.md
--- name: amplitude-user-lookup description: Finds one Amplitude user and lists their recent events. Use when support or product needs to see what a specific user did. --- # Amplitude user lookup 1. Ask for one identifier: user ID, device ID or Amplitude ID. 2. Call amplitude__read for user search, then for user activity of the match. 3. Output: the user summary and the last 20 events with timestamps, newest first. 4. If search returns several matches, list them and ask which one. Do not merge users. Do not paste the result into other tools. It can contain personal data.

Use it when: a support ticket needs the sequence of events behind one report.

10. Cohort and annotation review

Lists the cohorts defined in the project and the annotations on the chart timeline, so you know what is already named before you ask for new work.

SKILL.md
--- name: amplitude-cohort-review description: Lists Amplitude cohorts and chart annotations. Use when taking over a project or when asked what changed on a given date. --- # Amplitude cohort and annotation review 1. Call amplitude__read for cohorts. List name, size and last computed time where present. 2. Call amplitude__read for annotations. List date and label, newest first. 3. Group cohorts that look like duplicates by name and ask which to keep. Do not rename or delete anything: this tool cannot. 4. If the user gives a date, show the annotations within 3 days of it.

Use it when: you take over a project or need to match a metric change with a release note. The integrations hub lists the other platforms Ryze AI connects.

Quick Amplitude prompts: no skill file needed

For a one-time question, a plain prompt is enough once Claude can reach Amplitude. Replace the words in brackets and keep the date window short.

Prompt
In Amplitude, list the events in my project with their weekly uniques and tell me which 5 have the most.
Prompt
Run event segmentation for [event] over the last 14 days, split by platform and country, and rank the groups by uniques.
Prompt
Read the results of Amplitude chart [chart ID] and summarize the trend in 3 bullets.
Prompt
Show realtime active users in Amplitude and tell me whether the last hour looks normal for today.

If an answer looks off, ask Claude which Amplitude report it read and for which dates.

How to run the skills on live Amplitude data

A skill only describes the report; Claude needs a connection to run it. The Ryze AI connector gives Claude one Amplitude tool:

  1. amplitude__read

    What it does
    Runs a read-only Amplitude Dashboard REST API GET request for the connected project: event list, event segmentation, funnels, retention, active and new users, sessions, realtime, user activity and search, cohorts, annotations and saved chart results
    Used by
    Skills 01 to 10

Connect Amplitude in 4 steps

Copy the keys

In Amplitude, open Settings, Projects, pick the project, then General, and copy the API key and the secret key. The pair decides which project is connected.

Connect in Ryze AI

In the Ryze AI app, open Integrations, click Connect on the Amplitude card, fill in API key, Secret key and Data residency (us, or eu for EU-hosted projects), and click Continue.

Add the connector

Add https://connector.get-ryze.ai/mcp in Claude under Customize, Connectors and include the workspace. If you added it before connecting Amplitude, remove and re-add it, then start a new chat.

Run a skill

Ask a question that matches a skill description, or type the skill name in Claude Code, and check which report Claude read.

You can also ask the Ryze AI agent in Claude or ChatGPT to connect Amplitude: it sends a one-time link, valid once and for 24 hours, to a page where you enter the keys and the data residency. Details are in the Ryze AI help center Amplitude page and the Claude connect guide. The full tool reference is on the Amplitude MCP page. Connecting the connector is free; the tool needs an active plan or trial, from Paid Ads at $89 a month with a 7-day free trial (see pricing).

Ryze AI connects one Amplitude project per connection. Amplitude also hosts its own MCP server at https://mcp.amplitude.com/mcp (https://mcp.eu.amplitude.com/mcp for EU), with OAuth sign-in and more than 40 tools across analytics, experiments, taxonomy, cohorts and session replay. Amplitude lists it as a paid add-on on Plus, included on Enterprise and not included on Free and Growth. The skills on this page work with either, as long as the server can run the report each skill names.

Amplitude request limits

Amplitude documents 5 concurrent requests per API key and an hourly cost cap of 108,000. Cost is days times conditions times a factor per report: event segmentation adds 4 per group-by, a funnel counts each event twice and adds 4 per group-by, retention costs 8 and sessions cost 4. User search and user activity share a separate limit of 360 queries an hour. A request over a limit returns HTTP 429 (Amplitude Dashboard REST API).

Approvals

The only Amplitude tool is a read tool sent as GET, so the connector does not change anything in Amplitude. The Ryze AI chat starts on Skip all approvals; you can switch the Tool approvals picker if you want to confirm each call. In Claude, approvals are set per tool under Customize, Connectors, Ryze AI, Tool permissions.

Troubleshooting: when an Amplitude skill returns a wrong answer

Claude has no Amplitude tool

Claude keeps the tool list from when you added the connector. Remove and re-add it, then start a new chat (Ryze AI connector FAQ).

HTTP 429 or a cost error

A limit was reached. Shorten the date range, remove a group-by, or run fewer skills at once. Funnels and retention cost the most.

Credentials rejected

Amplitude returns 403 for invalid credentials. Copy the API key and secret key again from Settings, Projects, General, and check the data residency.

Wrong project

The key pair decides the project. To switch, click View on the Amplitude card, disconnect and connect again, or use another workspace.

Chart not found

Amplitude returns 404 for an unknown chart ID. Copy the ID from the chart URL and check that your keys belong to the same project.

Numbers differ from the Amplitude app

Check the date range, the time zone of the project and the funnel mode. The skills state the window they used so you can match it.

A skill tries to change data

The tool is GET only. Nothing can be created or edited, so make that change in Amplitude.

Sources

The verdict

Turn each recurring Amplitude question into a skill with a fixed report and a fixed output. Start with the weekly digest and the saved chart readout, run the realtime check after every release, and keep one-off questions as prompts.

Ryze AI runs these skills in Claude on live Amplitude data through 1 read-only tool. Check the first answer of each skill against the same chart in Amplitude, and keep date windows short to stay under Amplitude's request limits.

Frequently asked questions

What are Claude skills for Amplitude?
SKILL.md files that tell Claude which Amplitude report to read and how to present it. Claude loads one when a request matches its description, so each check keeps the same shape every time.
Do I need an Amplitude connection to use these skills?
No. Each skill also works on an export or a chart image you attach, if it has the fields the skill names. A connection removes that step and lets Claude read the report itself.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. Anthropic lists custom connectors on every Claude plan, with one custom connector on Free.
Can Claude change my Amplitude project through these skills?
No. The Ryze AI Amplitude tool sends GET requests only, so it cannot create or edit charts, cohorts or events.
Show 6 more questions
Which Amplitude keys do I need?
The project API key and secret key from Settings, Projects, the project, General, plus the data residency (us, or eu for EU-hosted projects). The key pair decides which project is connected.
Does it work with EU data residency?
Yes. Pick eu as the Data residency when you connect Amplitude in Ryze AI.
Why do the skills state a date window?
Amplitude counts the cost of a request by the number of days it covers, and it caps cost per hour. Short windows keep skills under that cap and make results repeatable.
How is this different from the Amplitude MCP server?
Amplitude hosts its own MCP server at https://mcp.amplitude.com/mcp with OAuth sign-in and more than 40 tools, offered as an add-on on Plus and included on Enterprise. Ryze AI gives 1 read-only Amplitude tool on the same connector as its other platforms. The skills work with either.
Can I connect more than one Amplitude project?
Not in one workspace. Ryze AI holds one Amplitude project per connection. To switch, disconnect and connect again with the other project's keys, or put the other project in another workspace.
Can the skills use ChatGPT instead of Claude?
The SKILL.md format is Anthropic's. The instructions inside work as prompts in any client connected to the Ryze AI connector, such as ChatGPT or the Ryze AI chat.

Related guides

Ryze AI: Amplitude skills on live data

7-day free trial, $89 a month flat

Start free trial