Skill Claude CodeCodex
Guide for using the Grafana MCP to monitor and diagnose the Node.js ingestion pipeline workers in production. Use when investigating event lag, drops, pipeline errors, person/group processing, Kafka consumer health, Redis, Postgres, ClickHouse downstream health, or any ingestion worker question. Covers prod-us and…
Skill Claude CodeCodex
Workflow for optimizing ClickHouse and HogQL queries. Use when a HogQL query, query runner, insight, or report is too slow; when a hand-written ClickHouse query (via syncexecute or in a migration) is too slow; when ClickHouse times out or hits memory limits; when investigating a slow system.querylog row; or when…
Skill Claude CodeCodex
Decide which tree a frontend file belongs in — products/ /frontend/ or frontend/src/scenes/ / — and explain why the boundary is real rather than stylistic. Use when adding a new scene, component, or logic file for a product; when creating a new directory under frontend/src/scenes/; when a product has UI in both trees…
Skill Claude CodeCodex
Write a playwright test, make sure it runs, and is not flaky.
Skill Claude CodeCodex
Scopes work to the desktop app at products/desktop — a nested standalone pnpm/turbo/Biome workspace imported from the now-archived PostHog/code repo, with posthog/posthog the only source of truth for PRs, CI and publishing, and not part of the root frontend or Django build. Use when the user says /posthog-desktop, or…
Skill Claude CodeCodex
Internal PostHog developer frontend/browser QA skill. Use only when a PostHog developer explicitly asks to run frontend QA, browser-test a PR, verify a UI flow against the local PostHog stack, use qa-frontend, or QA current frontend changes with browser/runtime evidence. Do not use for generic code review, PR review…
Skill Claude CodeCodex
Multi-agent QA review team for code changes. This skill should be used when the user asks to "review my code", "run QA", "qa-team", "review this branch", "code review", "check my changes", or wants a comprehensive multi-perspective code review of the current branch's changes. Spawns parallel specialist agents…
Skill Claude CodeCodex
Run ClickHouse system.querylog analysis via the internal Metabase API. Use when investigating slow queries, materialization candidates, per-team query performance, ClickHouse cost or memory issues, or any system.querylog question. Covers prod-us and prod-eu, SSO-gated cookie auth via hogli, and ready-to-run query…
Skill Claude CodeCodex
Run read-only SQL against the local Postgres app database (SELECT, EXPLAIN, EXPLAIN ANALYZE on SELECT). Default local URL postgres://posthog:posthog@localhost:5432/posthog; else DATABASEURL. Use when querying the local DB, inspecting tables, debugging data, or analyzing query plans. Mutations are strictly forbidden.
Skill Claude CodeCodex
Query tophog — the ingestion pipeline's heavy-hitter store in ClickHouse — to identify hot or expensive actors (teamid, distinctid, sessionid, partition) during incident triage. Use when investigating ingestion lag, a hot or lagging Kafka partition, expensive person processing, merge storms, or any "which team or…
Skill Claude CodeCodex
Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.
Skill Claude CodeCodex
The full review process for personhog coordination-protocol changes — leases, fencing, handoffs, supervisors, failure budgets, warming, and changelog semantics. Use before pushing or requesting review on any personhog protocol changeset, when asked for an exhaustive or careful review of personhog code, and after any…
MCP server Claude CodeCodexCursor +2
Official PostHog MCP Server for product analytics, feature flags, experiments, and more. Remote server at mcp.posthog.com.
Command Claude Code
Start the posthog.com Gatsby dev server locally.
Command Claude Code
Suggest internal links for a blog post, newsletter, or other content using the internal linking resource.
Settings file Claude Code
Agent settings declaring 4 allowed tools.
Skill Claude CodeCodex
Verify and update competitor product data by scraping competitor websites using WebFetch/WebSearch. Use when the user asks to verify, check, or update competitor information in competitorData files (like amplitude.tsx, mixpanel.tsx), or when they want to ensure competitor feature data is accurate and current. This…
Skill Claude CodeCodex
Convert a Substack newsletter post into a native posthog.com newsletter file. Fetches the content from a Substack URL, formats it with correct frontmatter and markdown, applies internal links, and re-hosts its images on Cloudinary. Omits Substack-specific sections (byline, related texts, job posts). Use when the user…
Skill Claude CodeCodex
Write copy that sounds like PostHog — direct, opinionated, developer-facing, and specific. Use this skill whenever Cory is drafting, editing, or critiquing copy intended for posthog.com or any PostHog channel: product pages, landing pages, taglines, headlines, hero copy, button labels, microcopy, blog posts…
Skill Claude CodeCodex
Convert a posthog.com blog or newsletter post into a markdown file formatted for posting as an X (Twitter) Article. Strips frontmatter, promotes the title to an H1, remaps headings to X's two heading levels (subheadings + bold), downloads all post images into a numbered folder, and appends a subscribe CTA for…
Instructions file CodexOpenCode
AGENTS.md instructions for PostHog/posthog.com, covering agents.md, making changes, prs, content prs and before you open a pr.
Instructions file
Claude Code instructions for PostHog/posthog.com, a project described as: Official docs, website, and handbook for PostHog.
Agent
Reference this guide when creating pages or working with app templates.
Agent
Use when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and misreading has a real cost, or when text reads as dense, hedged, or easy to misparse. Triggers: disambiguate, STE100 rewrite, apply Simplified…