Agent skill · marketing growth · jeremylongshore
posthog-reference-architecture
Design a maintainable PostHog integration boundary for event taxonomy, identity, groups, flags, privacy, regional routing, and delivery ownership. Use when planning or reviewing analytics architecture. Trigger with "PostHog architecture", "organize PostHog", or "PostHog design review".
Why this skill is useful
Provides specific integration patterns and event taxonomy for PostHog that the AI wouldn't reliably generate on its own.
What it needs
Requires posthog-js, posthog-node installed locally. Requires posthog account access. About 5k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
PostHog Reference Architecture Overview Production-grade architecture for PostHog analytics in a web application. Covers file structure, event taxonomy design, SDK initialization layers, feature flag management, group analytics for B2B, and data pipeline integration. Prerequisites PostHog Cloud project, or an explicitly risk-accepted hobby self-hosted instance with its reduced feature and support boundaries documented posthog-js and posthog-node SDKs Next.js or React application (patterns adapt to other frameworks) Authentication Browser and server capture use the public project token and the regional ingestion host. Private API automation uses a least-privilege personal API key or OAuth token only on trusted servers. Local feature-flag evaluation uses a feature flags secure API key passed through the Node SDK's personalApiKey option. Keep every secret in the deployment platform's secret manager; never expose private or secure keys in browser code, logs, source control, or event properties. Architecture Instructions Tool discipline Use Read to inspect the relevant configuration and implementation before proposing changes. Use Grep to locate initialization, capture, flag, and credential boundaries. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/posthog-reference-architecture