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

integration-react-vite — скилл для Claude Code

Скилл integration-react-vite встраивает аналитику PostHog в React-приложение на Vite без роутера: четыре шага настройки, идентификация пользователей, фича-флаги и трекинг ошибок.

MIT 107 установок ★ 80 обновлён 2026-10-24

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

Что делает integration-react-vite

Скилл проводит через четыре шага: basic-integration-1.0-begin.md, basic-integration-1.1-edit.md, basic-integration-1.2-revise.md и basic-integration-1.3-conclude.md. Рядом лежат справочники references/react.md и references/identify-users.md. Код он дописывает к тому, что уже есть в проекте, а не перестраивает структуру.

Ключи PostHog идут только через переменные окружения — хардкод исключён. Фича-флаги берутся хуками useFeatureFlagEnabled() и useFeatureFlagPayload(), они сами разбираются с загрузкой и внешней синхронизацией. Почти весь useEffect под запретом: производные значения считают при рендере, логику события держат в обработчике, колбэк родителю вызывают рядом с setState. Сам хук остаётся для связи с тем, что живёт вне React.

Идентификация — на логине и регистрации. Если есть бэкенд, клиентская сессия и distinct ID уходят в заголовках X-POSTHOG-DISTINCT-ID и X-POSTHOG-SESSION-ID, чтобы события сходились. Трекинг ошибок ставят вокруг критичных сценариев и границ API. Область узкая: Vite и никакого роутера. Если в приложении есть роутер, пример и шаги придётся переделывать под себя.

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

  • Подключить PostHog к React-приложению на Vite
  • Вынести ключи PostHog в переменные окружения
  • Поймать ошибки на критичных пользовательских сценариях
  • Связать события фронтенда с бэкендом по distinct ID
  • Перевести фича-флаги на хуки PostHog

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

  • Добавь PostHog в моё приложение на Vite, начиная с basic-integration-1.0-begin.md
  • Настрой идентификацию пользователей при логине по references/identify-users.md
  • Подключи фича-флаг через useFeatureFlagEnabled() и убери лишний useEffect из обработчика

Как установить integration-react-vite

1Через Skills CLI (Vercel)

npx skills add PostHog/skills --skill integration-react-vite -a claude-code

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

~/.claude/skills/integration-react-vite/SKILL.md

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

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

Вопросы об integration-react-vite

Как установить integration-react-vite в Claude Code?

Выполните npx skills add PostHog/skills --skill integration-react-vite -a claude-code. Файл скилла появится по пути ~/.claude/skills/integration-react-vite/SKILL.md.

Что делает integration-react-vite?

Ведёт агента по четырём шагам подключения PostHog к React-приложению на Vite, добавляет идентификацию пользователей при входе и регистрации, фича-флаги через хуки и трекинг ошибок.

Подойдёт ли скилл проекту с роутером?

Он описан для приложений на Vite без роутера, и пример проекта рассчитан на такую структуру. С роутером шаги и пример придётся адаптировать.

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

SKILL.md · MIT
---
name: integration-react-vite
description: PostHog integration for React applications built with Vite (no router)
metadata:
  author: PostHog
  version: 1.9.4
---

# PostHog integration for React (Vite)

This skill helps you add PostHog analytics to React (Vite) applications.

## Workflow

Follow these steps in order to complete the integration:

1. `basic-integration-1.0-begin.md` - PostHog Setup - Begin ← **Start here**
2. `basic-integration-1.1-edit.md` - PostHog Setup - Edit
3. `basic-integration-1.2-revise.md` - PostHog Setup - Revise
4. `basic-integration-1.3-conclude.md` - PostHog Setup - Conclusion

## Reference files

- `references/react.md` - React - docs
- `references/identify-users.md` - Identify users - docs
- `references/basic-integration-1.0-begin.md` - PostHog setup - begin
- `references/basic-integration-1.1-edit.md` - PostHog setup - edit
- `references/basic-integration-1.2-revise.md` - PostHog setup - revise
- `references/basic-integration-1.3-conclude.md` - PostHog setup - conclusion

The example project shows the target implementation pattern. Consult the documentation for API details.

## Key principles

- **Environment variables**: Always use environment variables for PostHog keys. Never hardcode them.
- **Minimal changes**: Add PostHog code alongside existing integrations. Don't replace or restructure existing code.
- **Match the example**: Your implementation should follow the example project's patterns as closely as possible.

## Framework guidelines

- For feature flags, use useFeatureFlagEnabled() or useFeatureFlagPayload() hooks - they handle loading states and external sync automatically
- Add analytics capture in event handlers where user actions occur, NOT in useEffect reacting to state changes
- Do NOT use useEffect for data transformation - calculate derived values during render instead
- Do NOT use useEffect to respond to user events - put that logic in the event handler itself
- Do NOT use useEffect to chain state updates - calculate all related updates together in the event handler
- Do NOT use useEffect to notify parent components - call the parent callback alongside setState in the event handler
- To reset component state when a prop changes, pass the prop as the component's key instead of using useEffect
- useEffect is ONLY for synchronizing with external systems (non-React widgets, browser APIs, network subscriptions)

## Identifying users

Identify users during login and signup events. Refer to the example code and documentation for the correct identify pattern for this framework. If both frontend and backend code exist, pass the client-side session and distinct ID using `X-POSTHOG-DISTINCT-ID` and `X-POSTHOG-SESSION-ID` headers to maintain correlation.

## Error tracking

Add PostHog error tracking to relevant files, particularly around critical user flows and API boundaries.

© PostHog · MIT · PostHog/skills

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

Все скиллы по теме «Фронтенд и UI» →
react-vite-best-practices agent-skills Скилл react-vite-best-practices для Claude Code с 23 правилами оптимизации React-приложений на Vite: сборка, code splitting, HMR, ассеты, окружение и анализ бандла. Проверяет компоненты при написании и ревью. CX Codex +1 3 000установок react-vite-dashboard официальный google-labs-code Скилл react-vite-dashboard превращает макеты из Stitch в рабочий код дашборда на React и Vite. Он связывает дизайн-токены из DESIGN.md с кодом и подключает выборку данных через TanStack Query. CX Codex +1 7 100установок vite-react-best-practices ant-gravity Скилл vite-react-best-practices задаёт агенту правила архитектуры, кэширования и деплоя для SPA на React 19 и Vite 8. Включается при сборке проекта, настройке роутинга или рефакторинге компонентов. CX Codex +1 670установок typescript-nodejs-react-vite-cursorrules-prompt-fi PatrickJS Правило typescript-nodejs-react-vite-cursorrules-prompt-fi для Cursor задаёт стиль TypeScript-кода для Node.js, React и Vite, включая TanStack Query, TanStack Router и Tailwind. При правках проекта сохраняет единые договорённости. CX Codex +1 ★ 41 178звёзд репо posthog-analytics alinaqi Скилл posthog-analytics для Claude Code помогает добавить в продукт аналитику PostHog, события и флаги функций. Подключается при работе с отслеживанием действий пользователей. CX Codex +1 827установок adding-analytics spencerpauly Скилл adding-analytics помогает ассистенту внедрить PostHog в веб-приложение: от настройки провайдера до трекинга событий, веб-аналитики и флагов фич. CX Codex +1 410установок

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

Весь набор →
feature-flags-api Скилл feature-flags-api помогает добавить feature flags от PostHog в API-приложение. Он пригодится, когда нужно встроить проверки флагов в существующий код. CX Codex +1 111установок integration-react-native Скилл integration-react-native помогает добавить аналитику PostHog в React Native-приложение, настроить идентификацию пользователей и отслеживание ошибок. CX Codex +1 109установок feature-flags-react-native Скилл feature-flags-react-native внедряет флаги функциональности PostHog в приложения на React Native без ручной настройки обвязки и лишних вызовов useEffect. CX Codex +1 109установок integration-astro-ssr Скилл integration-astro-ssr встраивает аналитику PostHog в SSR-проекты на Astro с API-роутами. Помогает связать клиентские и серверные события. CX Codex +1 109установок integration-swift Скилл integration-swift помогает настроить аналитику PostHog в приложениях на Swift под iOS и macOS по готовой четырёхшаговой схеме. CX Codex +1 108установок omnibus-instrument-llm-analytics Скилл omnibus-instrument-llm-analytics добавляет в код трейсинг вызовов LLM через PostHog: токены, задержки и стоимость каждой генерации. Заодно поставит SDK, если его ещё нет. CX Codex +1 106установок integration-nextjs-pages-router Скилл integration-nextjs-pages-router добавляет PostHog в приложения Next.js с Pages Router. Он ведёт агента по настройке аналитики, идентификации пользователей и отслеживанию ошибок. CX Codex +1 103установок integration-react-react-router-7-declarative Скилл integration-react-react-router-7-declarative для Claude Code пошагово подключает аналитику PostHog к приложениям на React Router v7 в декларативном режиме. CX Codex +1 102установок

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

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