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.
Used by 2,000+ marketers
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.
- 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
- 02Saved chart readoutTurn a saved chart into a short summary
Amplitude report it reads: Chart results by chart ID
Access: Read
- 03Event segmentationOne event split by up to 2 properties
Amplitude report it reads: Event segmentation
Access: Read
- 04Signup funnelWhere users drop between steps
Amplitude report it reads: Funnel analysis
Access: Read
- 05Retention checkWhich users come back
Amplitude report it reads: Retention
Access: Read
- 06Growth snapshotNew against active users over time
Amplitude report it reads: Active and new users
Access: Read
- 07Session healthSession length and sessions per user
Amplitude report it reads: Average sessions, sessions per user
Access: Read
- 08Realtime checkConfirm tracking after a release
Amplitude report it reads: Realtime active users
Access: Read
- 09User lookupFind a user and read their recent events
Amplitude report it reads: User search, user activity
Access: Read
- 10Cohort and annotation reviewList cohorts and the release notes on the timeline
Amplitude report it reads: Cohorts, annotations
Access: Read
| # | Skill | Job | Amplitude report it reads | Access |
|---|---|---|---|---|
| 01 | Weekly product digest | Active users, sessions and top events, week over week | Active and new users, average sessions, events list | Read |
| 02 | Saved chart readout | Turn a saved chart into a short summary | Chart results by chart ID | Read |
| 03 | Event segmentation | One event split by up to 2 properties | Event segmentation | Read |
| 04 | Signup funnel | Where users drop between steps | Funnel analysis | Read |
| 05 | Retention check | Which users come back | Retention | Read |
| 06 | Growth snapshot | New against active users over time | Active and new users | Read |
| 07 | Session health | Session length and sessions per user | Average sessions, sessions per user | Read |
| 08 | Realtime check | Confirm tracking after a release | Realtime active users | Read |
| 09 | User lookup | Find a user and read their recent events | User search, user activity | Read |
| 10 | Cohort and annotation review | List cohorts and the release notes on the timeline | Cohorts, annotations | 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.
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
Setup
- One-off prompt
- None
- Skill
- Save once per Claude app
- Amplitude connection
- API key, secret key and data residency
Same shape each run
- One-off prompt
- No
- Skill
- Yes
- Amplitude connection
- Depends on the prompt or skill
| One-off prompt | Skill | Amplitude connection | |
|---|---|---|---|
| What it is | A question typed in chat | A saved file with a fixed report and output | The tool Claude uses to reach your project |
| Setup | None | Save once per Claude app | API key, secret key and data residency |
| Same shape each run | No | Yes | 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.
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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:
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
| Tool | What it does | Used by |
|---|---|---|
| amplitude__read | 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 | 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.





