К основному содержанию
скилл CX Codex

amplitude-automation — скилл для Claude Code: автоматизация аналитики

Скилл amplitude-automation подключает Amplitude к IDE через Rube MCP и Composio. Отправляйте события, ищите пользователей, управляйте когортами прямо из редактора.

MIT 131 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill amplitude-automation -a claude-code
Открыть на GitHub

Что делает amplitude-automation

amplitude-automation работает через Rube MCP — промежуточный слой между IDE и Amplitude API. Сначала добавляете MCP-адрес https://rube.app/mcp в конфиг клиента, затем устанавливаете скилл. Внутри пять основных операций: отправка событий (AMPLITUDE_SEND_EVENTS), просмотр активности пользователя (AMPLITUDE_GET_USER_ACTIVITY), поиск и идентификация юзеров (AMPLITUDE_FIND_USER, AMPLITUDE_IDENTIFY), управление когортами (LIST, GET, UPDATE_MEMBERSHIP) и просмотр категорий событий.

Критические детали: события требуют либо user_id, либо device_id; временные метки — в миллисекундах с эпохи (13 цифр), не в секундах. Для получения истории активности нужно сначала вызвать AMPLITUDE_FIND_USER, чтобы преобразовать ваш user_id во внутренний ID Amplitude, иначе GET_USER_ACTIVITY не найдёт ничего. Обновления когорт работают асинхронно — результат проверяется через CHECK_COHORT_STATUS с request_id из ответа.

Скилл требует активного подключения Amplitude через Rube (RUBE_MANAGE_CONNECTIONS) и всегда рекомендует вызывать RUBE_SEARCH_TOOLS перед работой, чтобы получить актуальные схемы инструментов. Если Amplitude ещё не авторизована, Rube вернёт ссылку для подключения.

Какие задачи решает

  • отправить события в Amplitude из кода или промпта
  • найти пользователя по ID и посмотреть его активность
  • добавить или обновить свойства пользователя
  • управлять когортами: создавать, просматривать, добавлять пользователей
  • синхронизировать аналитику между IDE и Amplitude

Примеры запросов агенту

  • Отправь события покупки в Amplitude с user_id и event_type purchase
  • Найди пользователя по email и покажи его последние 50 событий
  • Обновите свойство $set plan на premium для всех юзеров из когорты enterprise

Как установить amplitude-automation

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill amplitude-automation -a claude-code

2Вручную: положить файлы

~/.claude/skills/amplitude-automation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/amplitude-automation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об amplitude-automation

Как установить amplitude-automation в Claude Code?

Выполните команду npx skills add davepoon/buildwithclaude --skill amplitude-automation -a claude-code, затем откройте файл ~/.claude/skills/amplitude-automation/SKILL.md. Перед этим убедитесь, что в конфиге IDE добавлен MCP-сервер https://rube.app/mcp.

Что нужно, чтобы amplitude-automation работал?

Нужен Rube MCP (добавляется как https://rube.app/mcp в конфиг клиента), активное подключение Amplitude через Rube и доступ к инструментам Composio Amplitude toolkit. API-ключи передаются через интерфейс авторизации Rube.

Почему GET_USER_ACTIVITY не находит события после отправки?

Во-первых, всегда вызывайте сначала AMPLITUDE_FIND_USER с вашим user_id — это преобразует его во внутренний ID Amplitude, который требует GET_USER_ACTIVITY. Во-вторых, события обрабатываются асинхронно и могут быть недоступны несколько секунд.

Исходный текст

SKILL.md · MIT
---
name: amplitude-automation
description: "Automate Amplitude tasks via Rube MCP (Composio): events, user activity, cohorts, user identification. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: analytics
---

# Amplitude Automation via Rube MCP

Automate Amplitude product analytics through Composio's Amplitude toolkit via Rube MCP.

**Toolkit docs**: [composio.dev/toolkits/amplitude](https://composio.dev/toolkits/amplitude)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Amplitude connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `amplitude`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `amplitude`
3. If connection is not ACTIVE, follow the returned auth link to complete Amplitude authentication
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. Send Events

**When to use**: User wants to track events or send event data to Amplitude

**Tool sequence**:
1. `AMPLITUDE_SEND_EVENTS` - Send one or more events to Amplitude [Required]

**Key parameters**:
- `events`: Array of event objects, each containing:
  - `event_type`: Name of the event (e.g., 'page_view', 'purchase')
  - `user_id`: Unique user identifier (required if no `device_id`)
  - `device_id`: Device identifier (required if no `user_id`)
  - `event_properties`: Object with custom event properties
  - `user_properties`: Object with user properties to set
  - `time`: Event timestamp in milliseconds since epoch

**Pitfalls**:
- At least one of `user_id` or `device_id` is required per event
- `event_type` is required for every event; cannot be empty
- `time` must be in milliseconds (13-digit epoch), not seconds
- Batch limit applies; check schema for maximum events per request
- Events are processed asynchronously; successful API response does not mean data is immediately queryable

### 2. Get User Activity

**When to use**: User wants to view event history for a specific user

**Tool sequence**:
1. `AMPLITUDE_FIND_USER` - Find user by ID or property [Prerequisite]
2. `AMPLITUDE_GET_USER_ACTIVITY` - Retrieve user's event stream [Required]

**Key parameters**:
- `user`: Amplitude internal user ID (from FIND_USER)
- `offset`: Pagination offset for event list
- `limit`: Maximum number of events to return

**Pitfalls**:
- `user` parameter requires Amplitude's internal user ID, NOT your application's user_id
- Must call FIND_USER first to resolve your user_id to Amplitude's internal ID
- Activity is returned in reverse chronological order by default
- Large activity histories require pagination via `offset`

### 3. Find and Identify Users

**When to use**: User wants to look up users or set user properties

**Tool sequence**:
1. `AMPLITUDE_FIND_USER` - Search for a user by various identifiers [Required]
2. `AMPLITUDE_IDENTIFY` - Set or update user properties [Optional]

**Key parameters**:
- For FIND_USER:
  - `user`: Search term (user_id, email, or Amplitude ID)
- For IDENTIFY:
  - `user_id`: Your application's user identifier
  - `device_id`: Device identifier (alternative to user_id)
  - `user_properties`: Object with `$set`, `$unset`, `$add`, `$append` operations

**Pitfalls**:
- FIND_USER searches across user_id, device_id, and Amplitude ID
- IDENTIFY uses special property operations (`$set`, `$unset`, `$add`, `$append`)
- `$set` overwrites existing values; `$setOnce` only sets if not already set
- At least one of `user_id` or `device_id` is required for IDENTIFY
- User property changes are eventually consistent; not immediate

### 4. Manage Cohorts

**When to use**: User wants to list cohorts, view cohort details, or update cohort membership

**Tool sequence**:
1. `AMPLITUDE_LIST_COHORTS` - List all saved cohorts [Required]
2. `AMPLITUDE_GET_COHORT` - Get detailed cohort information [Optional]
3. `AMPLITUDE_UPDATE_COHORT_MEMBERSHIP` - Add/remove users from a cohort [Optional]
4. `AMPLITUDE_CHECK_COHORT_STATUS` - Check async cohort operation status [Optional]

**Key parameters**:
- For LIST_COHORTS: No required parameters
- For GET_COHORT: `cohort_id` (from list results)
- For UPDATE_COHORT_MEMBERSHIP:
  - `cohort_id`: Target cohort ID
  - `memberships`: Object with `add` and/or `remove` arrays of user IDs
- For CHECK_COHORT_STATUS: `request_id` from update response

**Pitfalls**:
- Cohort IDs are required for all cohort-specific operations
- UPDATE_COHORT_MEMBERSHIP is asynchronous; use CHECK_COHORT_STATUS to verify
- `request_id` from the update response is needed for status checking
- Maximum membership changes per request may be limited; chunk large updates
- Only behavioral cohorts support API membership updates

### 5. Browse Event Categories

**When to use**: User wants to discover available event types and categories in Amplitude

**Tool sequence**:
1. `AMPLITUDE_GET_EVENT_CATEGORIES` - List all event categories [Required]

**Key parameters**:
- No required parameters; returns all configured event categories

**Pitfalls**:
- Categories are configured in Amplitude UI; API provides read access
- Event names within categories are case-sensitive
- Use these categories to validate event_type values before sending events

## Common Patterns

### ID Resolution

**Application user_id -> Amplitude internal ID**:
```
1. Call AMPLITUDE_FIND_USER with user=your_user_id
2. Extract Amplitude's internal user ID from response
3. Use internal ID for GET_USER_ACTIVITY
```

**Cohort name -> Cohort ID**:
```
1. Call AMPLITUDE_LIST_COHORTS
2. Find cohort by name in results
3. Extract id for cohort operations
```

### User Property Operations

Amplitude IDENTIFY supports these property operations:
- `$set`: Set property value (overwrites existing)
- `$setOnce`: Set only if property not already set
- `$add`: Increment numeric property
- `$append`: Append to list property
- `$unset`: Remove property entirely

Example structure:
```json
{
  "user_properties": {
    "$set": {"plan": "premium", "company": "Acme"},
    "$add": {"login_count": 1}
  }
}
```

### Async Operation Pattern

For cohort membership updates:
```
1. Call AMPLITUDE_UPDATE_COHORT_MEMBERSHIP -> get request_id
2. Call AMPLITUDE_CHECK_COHORT_STATUS with request_id
3. Repeat step 2 until status is 'complete' or 'error'
```

## Known Pitfalls

**User IDs**:
- Amplitude has its own internal user IDs separate from your application's
- FIND_USER resolves your IDs to Amplitude's internal IDs
- GET_USER_ACTIVITY requires Amplitude's internal ID, not your user_id

**Event Timestamps**:
- Must be in milliseconds since epoch (13 digits)
- Seconds (10 digits) will be interpreted as very old dates
- Omitting timestamp uses server receive time

**Rate Limits**:
- Event ingestion has throughput limits per project
- Batch events where possible to reduce API calls
- Cohort membership updates have async processing limits

**Response Parsing**:
- Response data may be nested under `data` key
- User activity returns events in reverse chronological order
- Cohort lists may include archived cohorts; check status field
- Parse defensively with fallbacks for optional fields

## Quick Reference

| Task | Tool Slug | Key Params |
|------|-----------|------------|
| Send events | AMPLITUDE_SEND_EVENTS | events (array) |
| Find user | AMPLITUDE_FIND_USER | user |
| Get user activity | AMPLITUDE_GET_USER_ACTIVITY | user, offset, limit |
| Identify user | AMPLITUDE_IDENTIFY | user_id, user_properties |
| List cohorts | AMPLITUDE_LIST_COHORTS | (none) |
| Get cohort | AMPLITUDE_GET_COHORT | cohort_id |
| Update cohort members | AMPLITUDE_UPDATE_COHORT_MEMBERSHIP | cohort_id, memberships |
| Check cohort status | AMPLITUDE_CHECK_COHORT_STATUS | request_id |
| List event categories | AMPLITUDE_GET_EVENT_CATEGORIES | (none) |

---
*Powered by [Composio](https://composio.dev)*

© davepoon · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
amplitude amplitude Плагин подключает Claude Code к Amplitude для анализа графиков, экспериментов, обратной связи и продуктовых возможностей. ★ 48звёзд репо Amplitude Experiment Implementation официальный github Субагент Amplitude Experiment Implementation для GitHub Copilot, который ведёт фичу от требований в issue до эксперимента в Amplitude и оборачивает код в его варианты. CX Codex +1 ★ 41 430звёзд репо outlook-calendar-automation sickn33 Скилл outlook-calendar-automation даёт агенту доступ к календарю Outlook через Rube MCP: создавать встречи, искать свободные окна, править и отменять события. CX Codex +1 967установок facebook-automation aAAaqwq Скилл facebook-automation управляет страницами, публикациями, комментариями, аналитикой и рекламными аккаунтами Facebook через Rube MCP. CX Codex +1 106установок github-automation davila7 Скилл github-automation для Claude, который проводит операции GitHub через Rube MCP: issues, пул-реквесты, ветки, поиск по коду и CI/CD. CX Codex +1 63установок discover-analytics-patterns amplitude Скилл discover-analytics-patterns находит реальные шаблоны аналитики в кодовой базе: вызовы SDK, обёртки, импорты и правила имён. Нужен перед добавлением новых событий. CX Codex +1 66 000установок

Из того же набора235

Весь набор →
agent-analytics Скилл agent-analytics подключает сбор веб-аналитики, воронки и A/B-тесты через CLI без тяжёлых дашбордов. Помогает агенту следить за трафиком проектов и оценивать конверсию. CX Codex +1 137установок oiloil-ui-ux-guide Скилл oiloil-ui-ux-guide даёт рекомендации по UI/UX или проверяет существующий интерфейс и выдаёт список правок с приоритетами. Пригодится при работе над веб-приложением или новой функцией. CX Codex +1 134установок ios-hig-design-guide Скилл ios-hig-design-guide для Claude Code готовит спецификации интерфейсов iOS по Apple Human Interface Guidelines. Он включается для вопросов о компонентах, доступности и правилах взаимодействия. CX Codex +1 133установок google-drive-automation Скилл google-drive-automation автоматизирует работу с Google Drive: загружает и скачивает файлы, ищет документы, создаёт папки, делится доступом. Работает через Rube MCP и Composio — нужна активная связь с Google Drive. CX Codex +1 133установок google-analytics-automation Скилл google-analytics-automation автоматизирует выгрузку отчётов и управление ресурсами Google Analytics 4 через сервер Rube MCP. CX Codex +1 130установок activecampaign-automation Скилл activecampaign-automation управляет контактами, тегами, списками и цепочками в ActiveCampaign через Rube MCP без ручного переключения в интерфейс CRM. CX Codex +1 128установок googlesheets-automation Скилл googlesheets-automation для автоматизации работы с Google Sheets: чтение и запись данных, управление вкладками, форматирование ячеек, фильтрация строк. Работает через Rube MCP и требует активного подключения к Google. CX Codex +1 128установок discord-automation Скилл discord-automation автоматизирует отправку сообщений, управление ролями, вебхуками и реакциями в Discord через Rube MCP и Composio. Помогает ботам работать с каналами и пользователями прямо из агента. CX Codex +1 128установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой