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

integration-javascript_web — скилл для Claude Code: установка и обзор

Скилл integration-javascript_web помогает встроить клиентскую веб-аналитику PostHog на базе библиотеки posthog-js в браузерное приложение.

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

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

Что делает integration-javascript_web

Скилл ведёт интеграцию через четырёхэтапный процесс: запуск, внесение изменений, правки и завершение. Внутри заложены правила работы с пакетом posthog-js: обязательный вызов posthog.init() до любых других методов, перенос ключей в переменные окружения и сохранение стандартного автозахвата кликов и форм.

Пакет рассчитан только на браузер. Импортировать его на сервере нельзя — для среды Node.js нужен отдельный posthog-node. Для связки клиентских событий с бэкендом скилл рекомендует передавать заголовки X-POSTHOG-DISTINCT-ID и X-POSTHOG-SESSION-ID.

Правила жёстко разграничивают данные: персональные сведения передаются только внутри posthog.identify(), а в свойства событий posthog.capture() их отправлять запрещено. При выходе пользователя вызывается posthog.reset().

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

  • интегрировать SDK posthog-js в клиентское приложение
  • настроить идентификацию пользователей при входе и перезагрузке
  • пробросить идентификаторы сессии на бэкенд через HTTP-заголовки
  • добавить отслеживание ошибок вокруг критических пользовательских сценариев

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

  • Подключи аналитику PostHog в наше клиентское веб-приложение через posthog-js
  • Настрой вызовы posthog.identify при входе в профиль и posthog.reset при выходе
  • Добавь трекинг ошибок PostHog на границах работы с API

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

1Через Skills CLI (Vercel)

npx skills add PostHog/skills --skill integration-javascript_web -a claude-code

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

~/.claude/skills/integration-javascript_web/SKILL.md

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

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

Вопросы об integration-javascript_web

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

Выполните команду npx skills add PostHog/skills --skill integration-javascript_web -a claude-code в терминале.

Что делает этот скилл?

Он даёт ИИ-агенту пошаговые инструкции и правила для корректного внедрения библиотеки posthog-js в веб-интерфейс без утечек персональных данных.

Можно ли использовать posthog-js на сервере в Node.js?

Библиотека posthog-js предназначена строго для браузерного окружения. Для серверного кода на Node.js требуется пакет posthog-node.

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

SKILL.md · MIT
---
name: integration-javascript_web
description: >-
  PostHog integration for client-side web JavaScript applications using
  posthog-js
metadata:
  author: PostHog
  version: 1.9.4
---

# PostHog integration for JavaScript Web

This skill helps you add PostHog analytics to JavaScript Web 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/js.md` - JavaScript web - docs
- `references/posthog-js.md` - PostHog JavaScript web SDK
- `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

- Remember that source code is available in the node_modules directory
- Check package.json for type checking or build scripts to validate changes
- posthog-js is the JavaScript SDK package name
- posthog.init() MUST be called before any other PostHog methods (capture, identify, etc.)
- posthog-js is browser-only — do NOT import it in Node.js or server-side contexts (use posthog-node instead)
- Autocapture is ON by default with posthog-js (tracks clicks, form submissions, pageviews). Do NOT disable autocapture unless the user explicitly requests it.
- NEVER send PII in posthog.capture() event properties — no emails, full names, phone numbers, physical addresses, IP addresses, or user-generated content
- PII belongs in posthog.identify() person properties (email, name, role), NOT in capture() event properties
- Call posthog.identify(userId, { email, name, role }) on login AND on page refresh if the user is already logged in
- Call posthog.reset() on logout to unlink future events from the current user
- For SPAs without a framework router, capture pageviews with posthog.capture($pageview) or use the capture_pageview history_change option in init for History API routing

## 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» →
javascript-pro davila7 Скилл javascript-pro для Claude, который ведёт агента по современному JavaScript: ES6+, промисы, event loop, API Node.js и браузера. CX Codex +1 79установок signals-scout-web-vitals PostHog Скилл signals-scout-web-vitals отслеживает p75 LCP, INP, CLS и FCP страниц по событиям PostHog, находит просадки скорости и сопоставляет их с релизами или выкаткой флагов. CX Codex +1 194установок zoom-video-sdk-web официальный Zoom Скилл zoom-video-sdk-web подсказывает агенту, как собрать кастомную видеосессию на Zoom Video SDK для Web: вход в сессию, камера, шаринг экрана, запись. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо js-request-idle-callback fcakyon Правило js-request-idle-callback учит агента уводить аналитику, сохранение состояния и предзагрузку в простой браузера, чтобы интерфейс не подвисал на кликах. CX Codex +1 ★ 1 216звёзд репо barba-js freshtechbro С инструкциями по Barba.js — библиотеке переходов между страницами на 7 кб. CX Codex +1 2 600установок route-based patterns.dev Скилл route-based для Claude Code показывает, как разбить SPA по маршрутам и лениво загружать код текущей страницы. CX Codex +1 1 600установок

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

Весь набор →
account-handover Скилл account-handover собирает отчёт для передачи клиента между TAM или CSM на основе данных Vitally и аналитики PostHog. CX Codex +1 193установок feature-flags-nextjs Скилл feature-flags-nextjs добавляет фича-флаги PostHog в приложение на Next.js: проверки в компонентах, оценку на сервере и управление флагами из чата, если подключён PostHog MCP-сервер. CX Codex +1 140установок writing-simplified-technical-english Скилл writing-simplified-technical-english переписывает английский текст по стандарту ASD-STE100: одно значение на слово, активный залог, короткие предложения. Для отчётов, PR-описаний, промптов и сообщений об ошибках. CX Codex +1 138установок integration-javascript_node Скилл integration-javascript_node ставит PostHog в серверное Node.js-приложение через posthog-node: события в роутах, идентификация пользователей, отлов исключений. CX Codex +1 131установок llm-analytics-setup Скилл llm-analytics-setup подключает LLM-аналитику PostHog к приложению на одном из поддерживаемых провайдеров: токены, задержка и стоимость каждого вызова. CX Codex +1 120установок experiment-audit Скилл experiment-audit для Claude Code проверяет настройку эксперимента PostHog, сбор данных по вариантам, атрибуцию и метрики. Запускается по просьбе проверить или провести аудит A/B-теста. CX Codex +1 118установок error-tracking-web Скилл error-tracking-web добавляет в веб-приложение на JavaScript сбор ошибок через PostHog: перехват исключений, source maps, алерты и разбор проблем. CX Codex +1 116установок monthly-to-annual Скилл monthly-to-annual для Claude Code готовит расчёт перехода клиента PostHog с помесячной оплаты на годовой кредитный план. По запросу о конверсии он формирует краткую сводку и черновик сообщения в Slack. CX Codex +1 115установок

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

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