integration-react-vite — скилл для Claude Code
Скилл integration-react-vite встраивает аналитику PostHog в React-приложение на Vite без роутера: четыре шага настройки, идентификация пользователей, фича-флаги и трекинг ошибок.
MIT 107 установок ★ 80 обновлён 2026-10-24
npx skills add PostHog/skills --skill integration-react-vite -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/integration-react-vite/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/integration-react-vite/
1Через Skills CLI (Vercel)
npx skills add PostHog/skills --skill integration-react-vite -a codex2Вручную: положить файлы
.agents/skills/integration-react-vite/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add PostHog/skills --skill integration-react-vite -a cursor2Вручную: положить файлы
.cursor/skills/integration-react-vite/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install PostHog/skills skills/posthog/all/skills/integration-react-vite2Вручную: положить файлы
.github/skills/integration-react-vite/SKILL.md1Через Skills CLI (Vercel)
npx skills add PostHog/skills --skill integration-react-vite -a gemini-cli2Командой платформы
gemini skills install https://github.com/PostHog/skills --path skills/posthog/all/skills/integration-react-viteВручную: положить файлы
.devin/skills/integration-react-vite/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add PostHog/skills --skill integration-react-vite -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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