What is the difference between capture() and captureImmediate()?

capture() batches events for efficiency but requires an explicit flush(), while captureImmediate() sends the event instantly, making it simpler for serverless environments.

Does this skill support the latest PostHog features?

Yes, it enforces the use of the 2026-01-30 defaults date to enable automatic SPA page tracking and the latest recommended SDK behaviors.

Can I initialize posthog-js on the server?

No, the posthog-js library requires browser APIs like window and localStorage; you must use posthog-node for server-side environments or API routes.

How do I prevent data loss in serverless functions?

You must call posthog.flush(), posthog.shutdown(), or use captureImmediate() to ensure events are sent to PostHog before the function execution terminates.

What is the benefit of the 'identified_only' setting?

This setting reduces costs and noise by only creating person profiles for authenticated users rather than every anonymous visitor.

PostHog Analytics & Feature Flags Setup

Name: PostHog Analytics & Feature Flags Setup
Author: agents-inc

byagents-inc

•

Analytics & Monitoring

Configures PostHog for comprehensive product analytics and feature flag management across client and server environments.

This skill streamlines the initial setup of PostHog within your application, providing production-ready patterns for both client-side tracking using posthog-js and server-side event capture with posthog-node. It enforces best practices such as environment variable configuration, secure user identification, and proper event flushing in serverless environments to ensure zero data loss while optimizing performance and costs. Ideal for developers looking to consolidate tracking and flags into a single, high-performance platform.

Key Features

01Server-side posthog-node singleton setup for API routes

02Client-side posthog-js provider and hook initialization

03Cost-optimized 'identified_only' person profile configuration

04Automated environment variable configuration and prefixing

05Support for latest 2026-01-30 defaults for SPA tracking

063 GitHub stars

Use Cases

01Initializing PostHog in a new React, Next.js, or Node.js project

02Consolidating separate analytics and feature flag tools into one platform

03Ensuring reliable event capture in serverless/Edge environments with proper flush patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agents-inc/skills api-analytics-setup-posthog

For use in Claude.ai and ChatGPT

Key Features

01Server-side posthog-node singleton setup for API routes

02Client-side posthog-js provider and hook initialization

03Cost-optimized 'identified_only' person profile configuration

04Automated environment variable configuration and prefixing

05Support for latest 2026-01-30 defaults for SPA tracking

063 GitHub stars

Use Cases

01Initializing PostHog in a new React, Next.js, or Node.js project

02Consolidating separate analytics and feature flag tools into one platform

03Ensuring reliable event capture in serverless/Edge environments with proper flush patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agents-inc/skills api-analytics-setup-posthog

For use in Claude.ai and ChatGPT