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

posthog-automation — скилл для Claude Code и Cursor

Скилл posthog-automation для Claude Code автоматизирует работу с PostHog через Rube MCP: отправляет события и управляет feature-флагами, проектами, профилями пользователей и аннотациями.

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

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

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

Подключается к PostHog через MCP-сервер Rube (Composio): агент обращается к инструментам POSTHOG_* через RUBE_SEARCH_TOOLS, поэтому схемы всегда актуальны.

Основные операции: отправка событий через POSTHOG_CAPTURE_EVENT с обязательным distinct_id, фильтрация событий по дате и пользователю, создание и листинг feature-флагов с правилами таргетинга, просмотр проектов организации. Флаги поддерживают группы условий с rollout_percentage — изменения вступают в силу за секунды после сохранения. Системные события PostHog используют префикс $; собственные события его не должны содержать, иначе API вернёт ошибку.

Для запуска нужен подключённый Rube MCP: добавьте https://rube.app/mcp как MCP-сервер в конфигурации клиента, затем вызовите RUBE_MANAGE_CONNECTIONS с toolkit posthog и пройдите авторизацию по ссылке из ответа. API-ключи отдельно не нужны.

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

  • отправить аналитические события в PostHog с нужными свойствами
  • создать feature-флаг с таргетингом по домену email и процентом раскатки
  • получить список всех проектов организации и извлечь числовые ID
  • отфильтровать события конкретного пользователя за заданный период
  • проверить статус подключения и права текущего API-пользователя

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

  • Отправь событие purchase_completed в PostHog с distinct_id пользователя и суммой заказа
  • Создай feature-флаг new-dashboard-beta и огради его на 10% пользователей
  • Покажи все события пользователя с person_id за последние 24 часа

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о posthog-automation

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

Выполните npx skills add davepoon/buildwithclaude --skill posthog-automation -a claude-code. Скилл появится в ~/.claude/skills/posthog-automation/SKILL.md.

Что делает скилл posthog-automation?

Он добавляет агенту набор инструкций для работы с PostHog через Rube MCP: отправка и фильтрация событий, управление feature-флагами, просмотр проектов и профилей пользователей.

Нужен ли отдельный API-ключ PostHog для работы скилла?

Отдельный ключ не нужен. Достаточно добавить https://rube.app/mcp как MCP-сервер и подключить toolkit posthog через RUBE_MANAGE_CONNECTIONS, пройдя OAuth-авторизацию.

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

SKILL.md · MIT
---
name: posthog-automation
description: "Automate PostHog tasks via Rube MCP (Composio): events, feature flags, projects, user profiles, annotations. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: devops
---

# PostHog Automation via Rube MCP

Automate PostHog product analytics and feature flag management through Composio's PostHog toolkit via Rube MCP.

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

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active PostHog connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `posthog`
- 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 `posthog`
3. If connection is not ACTIVE, follow the returned auth link to complete PostHog authentication
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. Capture Events

**When to use**: User wants to send event data to PostHog for analytics tracking

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

**Key parameters**:
- `event`: Event name (e.g., '$pageview', 'user_signed_up', 'purchase_completed')
- `distinct_id`: Unique user identifier (required)
- `properties`: Object with event-specific properties
- `timestamp`: ISO 8601 timestamp (optional; defaults to server time)

**Pitfalls**:
- `distinct_id` is required for every event; identifies the user/device
- PostHog system events use `$` prefix (e.g., '$pageview', '$identify')
- Custom events should NOT use the `$` prefix
- Properties are freeform; maintain consistent schemas across events
- Events are processed asynchronously; ingestion delay is typically seconds

### 2. List and Filter Events

**When to use**: User wants to browse or search through captured events

**Tool sequence**:
1. `POSTHOG_LIST_AND_FILTER_PROJECT_EVENTS` - Query events with filters [Required]

**Key parameters**:
- `project_id`: PostHog project ID (required)
- `event`: Filter by event name
- `person_id`: Filter by person ID
- `after`: Events after this ISO 8601 timestamp
- `before`: Events before this ISO 8601 timestamp
- `limit`: Maximum events to return
- `offset`: Pagination offset

**Pitfalls**:
- `project_id` is required; resolve via LIST_PROJECTS first
- Date filters use ISO 8601 format (e.g., '2024-01-15T00:00:00Z')
- Large event volumes require pagination; use `offset` and `limit`
- Results are returned in reverse chronological order by default
- Event properties are nested; parse carefully

### 3. Manage Feature Flags

**When to use**: User wants to create, view, or manage feature flags

**Tool sequence**:
1. `POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS` - List existing feature flags [Required]
2. `POSTHOG_RETRIEVE_FEATURE_FLAG_DETAILS` - Get detailed flag configuration [Optional]
3. `POSTHOG_CREATE_FEATURE_FLAGS_FOR_PROJECT` - Create a new feature flag [Optional]

**Key parameters**:
- For listing: `project_id` (required)
- For details: `project_id`, `id` (feature flag ID)
- For creation:
  - `project_id`: Target project
  - `key`: Flag key (e.g., 'new-dashboard-beta')
  - `name`: Human-readable name
  - `filters`: Targeting rules and rollout percentage
  - `active`: Whether the flag is enabled

**Pitfalls**:
- Feature flag `key` must be unique within a project
- Flag keys should use kebab-case (e.g., 'my-feature-flag')
- `filters` define targeting groups with properties and rollout percentages
- Creating a flag with `active: true` immediately enables it for matching users
- Flag changes take effect within seconds due to PostHog's polling mechanism

### 4. Manage Projects

**When to use**: User wants to list or inspect PostHog projects and organizations

**Tool sequence**:
1. `POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION` - List all projects [Required]

**Key parameters**:
- `organization_id`: Organization identifier (may be optional depending on auth)
- `limit`: Number of results per page
- `offset`: Pagination offset

**Pitfalls**:
- Project IDs are numeric; used as parameters in most other endpoints
- Organization ID may be required; check your PostHog setup
- Pagination is offset-based; iterate until results are empty
- Project settings include API keys and configuration details

### 5. User Profile and Authentication

**When to use**: User wants to check current user details or verify API access

**Tool sequence**:
1. `POSTHOG_WHOAMI` - Get current API user information [Optional]
2. `POSTHOG_RETRIEVE_CURRENT_USER_PROFILE` - Get detailed user profile [Optional]

**Key parameters**:
- No required parameters for either call
- Returns current authenticated user's details, permissions, and organization info

**Pitfalls**:
- WHOAMI is a lightweight check; use for verifying API connectivity
- User profile includes organization membership and permissions
- These endpoints confirm the API key's access level and scope

## Common Patterns

### ID Resolution

**Organization -> Project ID**:
```
1. Call POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION
2. Find project by name in results
3. Extract id (numeric) for use in other endpoints
```

**Feature flag name -> Flag ID**:
```
1. Call POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS with project_id
2. Find flag by key or name
3. Extract id for detailed operations
```

### Feature Flag Targeting

Feature flags support sophisticated targeting:
```json
{
  "filters": {
    "groups": [
      {
        "properties": [
          {"key": "email", "value": "@company.com", "operator": "icontains"}
        ],
        "rollout_percentage": 100
      },
      {
        "properties": [],
        "rollout_percentage": 10
      }
    ]
  }
}
```
- Groups are evaluated in order; first matching group determines the rollout
- Properties filter users by their traits
- Rollout percentage determines what fraction of matching users see the flag

### Pagination

- Events: Use `offset` and `limit` (offset-based)
- Feature flags: Use `offset` and `limit` (offset-based)
- Projects: Use `offset` and `limit` (offset-based)
- Continue until results array is empty or smaller than `limit`

## Known Pitfalls

**Project IDs**:
- Required for most API endpoints
- Always resolve project names to numeric IDs first
- Multiple projects can exist in one organization

**Event Naming**:
- System events use `$` prefix ($pageview, $identify, $autocapture)
- Custom events should NOT use `$` prefix
- Event names are case-sensitive; maintain consistency

**Feature Flags**:
- Flag keys must be unique within a project
- Use kebab-case for flag keys
- Changes propagate within seconds
- Deleting a flag is permanent; consider disabling instead

**Rate Limits**:
- Event ingestion has throughput limits
- Batch events where possible for efficiency
- API endpoints have per-minute rate limits

**Response Parsing**:
- Response data may be nested under `data` or `results` key
- Paginated responses include `count`, `next`, `previous` fields
- Event properties are nested objects; access carefully
- Parse defensively with fallbacks for optional fields

## Quick Reference

| Task | Tool Slug | Key Params |
|------|-----------|------------|
| Capture event | POSTHOG_CAPTURE_EVENT | event, distinct_id, properties |
| List events | POSTHOG_LIST_AND_FILTER_PROJECT_EVENTS | project_id, event, after, before |
| List feature flags | POSTHOG_LIST_AND_MANAGE_PROJECT_FEATURE_FLAGS | project_id |
| Get flag details | POSTHOG_RETRIEVE_FEATURE_FLAG_DETAILS | project_id, id |
| Create flag | POSTHOG_CREATE_FEATURE_FLAGS_FOR_PROJECT | project_id, key, filters |
| List projects | POSTHOG_LIST_PROJECTS_IN_ORGANIZATION_WITH_PAGINATION | organization_id |
| Who am I | POSTHOG_WHOAMI | (none) |
| User profile | POSTHOG_RETRIEVE_CURRENT_USER_PROFILE | (none) |

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

© davepoon · MIT · davepoon/buildwithclaude

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

Все скиллы по теме «DevOps и инфраструктура» →
posthog-analytics alinaqi Скилл posthog-analytics для Claude Code помогает добавить в продукт аналитику PostHog, события и флаги функций. Подключается при работе с отслеживанием действий пользователей. CX Codex +1 827установок posthog официальный PostHog Inc. Анализирует данные продукта и управляет фиче-флагами, экспериментами или трекингом ошибок в PostHog прямо из диалога с агентом. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо posthog-stinger Legion Code Inc. Скилл posthog-stinger помогает настроить аналитику PostHog в проектах на SvelteKit 5 и Vercel. Полезен при поломке трекинга SPA, настройке фича-флагов и проксировании запросов. CX Codex +1 ★ 96звёзд репо PostHog MCP Server PostHog Подключает PostHog к ИИ-клиентам для аналитики событий и управления флагами функциональности. CX Codex +1 ★ 41 008звёзд репо posthog-wasp-drone Legion Code Inc. Субагент posthog-wasp-drone помогает настроить аналитику PostHog в SvelteKit: отслеживание страниц, флаги функций, A/B-тесты и прокси на Vercel. CX Codex ★ 96звёзд репо posthog-cost-tuning Jeremy Longshore Скилл posthog-cost-tuning считает, за что PostHog выставляет счёт, и режет шум в захвате событий, не теряя данные, нужные для решений. CX Codex +1 1установок

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

Весь набор →
miro-automation Скилл miro-automation управляет досками Miro через Rube MCP: создаёт стикеры, фреймы и связи, ищет элементы и настраивает доступ для коллег. CX Codex +1 123установок vercel-automation Скилл vercel-automation управляет проектами Vercel через Rube MCP: помогает разбирать деплои, настраивать переменные окружения и работать с доменами и DNS. CX Codex +1 123установок close-automation Скилл close-automation автоматизирует рутину в Close CRM через Rube MCP: заводит лидов, регистрирует звонки и SMS, ставит задачи и находит заметки. CX Codex +1 122установок circleci-automation Скилл circleci-automation для Claude Code управляет CircleCI через Rube MCP: запускает пайплайны, проверяет статусы воркфлоу и джобов, скачивает артефакты и результаты тестов. Требует активной авторизации CircleCI через Composio. CX Codex +1 122установок wrike-automation Скилл wrike-automation для Claude Code автоматизирует работу с Wrike через Rube MCP: задачи, папки, проекты, исполнителей и статусы. Управляет проектами из чата с агентом. CX Codex +1 121установок zoho-crm-automation Скилл zoho-crm-automation для автоматизации операций в Zoho CRM через Rube MCP: создание и обновление записей, поиск контактов, управление лидами и их конвертация. Нужна активная подписка на Zoho и подключение Rube MCP. CX Codex +1 121установок freshservice-automation Скилл freshservice-automation автоматизирует работу с заявками Freshservice через Rube MCP: поиск, создание, массовое обновление и отправка уведомлений. CX Codex +1 121установок stripe-automation Скилл stripe-automation управляет платежами, подписками, счетами и возвратами в Stripe через шлюз Rube MCP прямо из чата с агентом. CX Codex +1 120установок

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

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