posthog/posthog-foss

1

adding-personhog-rpc Guide for adding a new RPC to personhog-replica and personhog-router. Covers eligibility checks, proto definition, co…

posthog/posthog-foss

5

2

adding-project-secret-api-key-auth How to gate a PostHog API endpoint with project secret API key (PSAK) auth — a project-scoped, user-less service cred…

posthog/posthog-foss

5

3

adopting-generated-api-types Use when migrating frontend code from manual API client calls (`api.get`, `api.create`, `api.surveys.get`, `api.dashb…

posthog/posthog-foss

5

4

clickhouse-migrations ClickHouse migration patterns and rules. Use when creating or modifying ClickHouse migrations.

posthog/posthog-foss

5

5

debugging-ci-failures Debugs failing GitHub Actions CI runs for PostHog PRs, commits, and branches, and answers broad CI-health questions (…

posthog/posthog-foss

5

6

depot-container-builds Configures and runs Depot remote container builds using `depot build` and `depot bake`. Use when building Docker imag…

posthog/posthog-foss

5

7

depot-github-runners Configures Depot-managed GitHub Actions runners as a drop-in replacement for GitHub-hosted runners. Use when setting …

posthog/posthog-foss

5

8

django-migrations Django migration patterns and safety workflow for PostHog.

posthog/posthog-foss

5

9

django-startup-time Keep heavy imports off the django.setup() path that every process (web, celery, temporal, migrate, shell, CI) pays fo…

posthog/posthog-foss

5

10

documenting-warehouse-sources Write or update the user-facing posthog.com documentation for a PostHog Data warehouse import source.

posthog/posthog-foss

5

11

establishing-code-ownership Determine which PostHog team owns a file, directory, or code path, or enumerate all code a team owns (via distributed…

posthog/posthog-foss

5

12

fixing-flaky-tests Guides an agent through reproducing, root-causing, fixing, and validating flaky tests in the PostHog monorepo. Use wh…

posthog/posthog-foss

5

13

gating-production-deploys Use when adding or editing a GitHub Actions workflow that pushes a container image to a registry (ECR/ghcr/Docker Hub…

posthog/posthog-foss

5

14

generating-clickhouse-query-performance-reports Produce and structure slow-query performance reports for PostHog's production ClickHouse (US and EU). Use when asked …

posthog/posthog-foss

5

15

hogli PostHog developer CLI and repo tooling reference. Use when the user mentions hogli, asks about repo CLI tools, bin sc…

posthog/posthog-foss

5

16

implementing-agent-modes Guidelines to create/update a new mode for PostHog AI agent. Modes are a way to limit what tools, prompts, and prompt…

posthog/posthog-foss

5

17

implementing-mcp-tools Guide for exposing PostHog product endpoints as MCP tools. Use when creating new or updating API endpoints, adding MC…

posthog/posthog-foss

5

18

implementing-mcp-ui-apps Guide for adding MCP UI apps — interactive visualizations that render tool results in MCP clients like Claude Desktop…

posthog/posthog-foss

5

19

implementing-warehouse-sources Implement and extend PostHog Data warehouse import sources.

posthog/posthog-foss

5

20

improving-drf-endpoints Use when editing, reviewing, or auditing DRF viewsets and serializers in PostHog.

posthog/posthog-foss

5

21

ingestion-pipeline-doctor-nodejs Ingestion pipeline architecture overview and convention reference. Use when you need a quick orientation to the pipel…

posthog/posthog-foss

5

22

isolating-product-facade-contracts Plan and execute product isolation migrations to a facade plus contract layer in PostHog, following the Visual review…

posthog/posthog-foss

5

23

manage-dashboard-widgets Guides PostHog engineers through dashboard widget platform work — ship a new widget_type (WIDGET_REGISTRY, catalog, r…

posthog/posthog-foss

5

24

managing-github-actions-secrets Creates and updates GitHub Actions secrets for PostHog workflows. Use when adding a new CI secret, rotating an existi…

posthog/posthog-foss

5

25

modifying-taxonomic-filter Guides safe modification of the TaxonomicFilter — PostHog's multi-tab picker for events, actions, properties, cohorts…

posthog/posthog-foss

5

26

monitoring-capture-service Guide for using the Grafana MCP to monitor and diagnose the capture service (rust/capture) in production. Use when in…

posthog/posthog-foss

5

27

monitoring-ingestion-pipeline Guide for using the Grafana MCP to monitor and diagnose the Node.js ingestion pipeline workers in production. Use whe…

posthog/posthog-foss

5

28

optimizing-clickhouse-and-hogql-queries Workflow for optimizing ClickHouse and HogQL queries. Use when a HogQL query, query runner, insight, or report is too…

posthog/posthog-foss

5

29

playwright-test Write a playwright test, make sure it runs, and is not flaky.

posthog/posthog-foss

5

30

qa-team Multi-agent QA review team for code changes. This skill should be used when the user asks to "review my code", "run Q…

posthog/posthog-foss

5

31

query-clickhouse-via-metabase Run ClickHouse `system.query_log` analysis via the internal Metabase API. Use when investigating slow queries, materi…

posthog/posthog-foss

5

32

querying-local-postgres Run read-only SQL against the local Postgres app database (SELECT, EXPLAIN, EXPLAIN ANALYZE on SELECT).

posthog/posthog-foss

5

33

react-doctor Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing s…

posthog/posthog-foss

5

34

run-posthog Start, inspect, and drive the PostHog dev stack. Use for /run and /verify on this repo — when asked to launch PostHog…

posthog/posthog-foss

5

35

scene-menu-bar Conventions for adding or editing the SceneMenuBar above a scene's <SceneTitleSection>. Use when adding new menu item…

posthog/posthog-foss

5

36

security-audit Focused security audit of code, calibrated to surface real exploitable bugs and suppress theoretical findings. Use wh…

posthog/posthog-foss

5

37

sending-notifications How to send real-time in-app notifications from PostHog backend code. Use when integrating notifications into a new f…

posthog/posthog-foss

5

38

setting-feature-flags-in-storybook Use when writing a Storybook story for a component gated on a feature flag — boolean flags or multivariate/experiment…

posthog/posthog-foss

5

39

setting-up-devbox Guide a PostHog engineer through spinning up, connecting to, running commands on, and mirroring local code to a remot…

posthog/posthog-foss

5

40

setup-web-tests Set up Python test environment in Claude Code for web where flox is unavailable. Use when you need to run backend tes…

posthog/posthog-foss

5

41

survey-sdk-audit Audit PostHog survey SDK features and version requirements

posthog/posthog-foss

5

42

using-kea-disposables Use when adding timers (`setInterval`, `setTimeout`), event listeners (`window.addEventListener`, `document.addEventL…

posthog/posthog-foss

5

43

visualizing-change-over-time Helps PostHog engineers and agents pick the right chart when a request is about visualizing change over time, before/…

posthog/posthog-foss

5

44

writing-clickhouse-queries Guide for writing performant ClickHouse queries in PostHog product code.

posthog/posthog-foss

5

45

writing-kea-logics Guide for writing or reviewing PostHog kea logic files (`*Logic.ts` / `*Logic.tsx`).

posthog/posthog-foss

5

46

writing-skills Guide for writing PostHog agent skills — job-to-be-done templates that teach agents how to use MCP tools to achieve a…

posthog/posthog-foss

5

47

writing-tests Gates whether a new test should exist and forces it to be efficient, protecting CI from low-value test bloat. Use bef…

posthog/posthog-foss

5

48

making-scenes-tab-aware Guides converting PostHog frontend scenes to be tab aware for internal scene tabs. Use when adding or refactoring a `…

posthog/posthog-foss

3

49

running-ci-preflight Catch the deterministic CI failures reachable from your diff before pushing, with `hogli ci:preflight`. Use when the …

posthog/posthog-foss

2

50

querying-tophog Query tophog — the ingestion pipeline's heavy-hitter store in ClickHouse — to identify hot or expensive actors (team_…

posthog/posthog-foss

1