querying-posthog-data
This skill teaches agents how to query PostHog data using typed tools for product analytics or SQL when needed.
Identity proven by GitHub's verified organisation badge (PostHog)
- Agents
- Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, claude.ai and API
- License
- No license stated
- Pin
- e0fbf5epinned Oct 9, 2026
- Context cost
- about 3,900 tokenswhen the skill loads
- GitHub stars
- 88on posthog/ai-plugin
- Scripts
- None found
What it does
“Explains how to query PostHog data, defaulting to typed runners for supported product analytics. Read it before you write HogQL/SQL. Also read it before you call execute-sql against PostHog. Use it to find or aggregate PostHog entities. These entities include insights, dashboards, cohorts, feature flags, experiments, surveys, hog flows, warehouse data, and persons. Use it for trends, funnels, retention, lifecycle, paths, stickiness, web analytics, error tracking, logs, sessions, and LLM traces. Before you calculate a governed business or telemetry measure, check system.information_schema.metrics for an approved definition. Examples include MRR, activation, billable usage, active organizations, and failure rates. Use the approved definition before you derive a measure from raw events or use a typed domain tool. It also covers HogQL differences, system table schemas, functions, query examples, and schema discovery.”
Generated summary from the skill's own text
This skill teaches agents how to query PostHog data using typed tools for product analytics or SQL when needed. It covers selecting the right query method, finding specific PostHog entities, accessing the semantic layer for governed business measures, and provides schema references for all PostHog tables and example queries across analytics domains.
When to use it
- Finding specific PostHog entities like insights, dashboards, cohorts, or feature flags by ID
- Running product analytics queries like trends, funnels, retention, or paths using typed tools
- Querying governed business measures or telemetry metrics from the data catalog
- Discovering schema, event properties, or entity details before constructing queries
When not to
- When you need to execute arbitrary Python code or interact with external APIs
- When the harness does not support PostHog query rendering or the user has disabled analytics features
Install
No license stated: install from the publisher's repository, and ask the author before you reuse or share it.
These commands install from the publisher's repository and need no account.
skills CLI
npx skills add posthog/ai-plugin --skill querying-posthog-dataInstalls from the repository's default branch, which may have changed since the commit we checked.
GitHub CLI 2.90 or later
gh skill install posthog/ai-plugin querying-posthog-data@e0fbf5e742fb4242c4ea509b395b2e343642f0b7Installs the commit we checked (e0fbf5e).
Copy by hand
Download the folder at e0fbf5e and put it in .claude/skills/querying-posthog-data for Claude Code and in .agents/skills/querying-posthog-data for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.
Claude Code plugin
/plugin install posthog@claude-plugins-officialThe publisher's plugin in Claude's official marketplace. It may hold more than this skill, and we have not pinned it.
Copy for your agent
A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.
Prompt
Install the agent skill "querying-posthog-data" by PostHog. Source, pinned to commit e0fbf5e742fb4242c4ea509b395b2e343642f0b7: https://github.com/posthog/ai-plugin/tree/e0fbf5e742fb4242c4ea509b395b2e343642f0b7/skills/querying-posthog-data 1. Download that folder at exactly this commit. Do not use the default branch. 2. Copy every file unchanged, keeping the folder structure, into .claude/skills/querying-posthog-data/ for Claude Code and .agents/skills/querying-posthog-data/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist. 3. Do not edit the files, and do not run any script in the folder unless I ask you to. 4. When you are done, list the files you copied and where you put them. Its license is restricted or not stated. Show me the license terms from the repository before you copy anything. Listing and checks: https://www.agentnative.dev/skills/posthog/querying-posthog-data
SKILL.md at the pin
The license of this skill does not let us show its files here.
Files
- SKILL.md16 KB · a94336018055
- references/
- available-functions.md12 KB · 433b00f1e65c
- example-error-tracking.md3.0 KB · 20f98695544b
- example-event-taxonomy.md2.4 KB · 59ff965c9d40
- example-funnel-breakdown.md3.3 KB · 44f7b9ae2eec
- example-funnel-trends.md2.2 KB · 7f1fb3fd8336
- example-lifecycle.md3.8 KB · baf6af762756
- example-llm-trace.md5.1 KB · 880b7c00ce95
- example-llm-traces-list.md4.3 KB · d728225a717f
- example-logs.md1.2 KB · edb1a7cd30fa
- example-observability-correlation.md4.9 KB · 11391e53754f
- example-paths.md5.4 KB · f30ed013e6cc
- example-person-property-taxonomy.md630 B · 16e6c20aad7b
- example-retention.md2.6 KB · 73ff58887a1d
- example-session-replay.md2.0 KB · ed12a9fe67bc
- example-sessions.md468 B · ee04d20457f5
- example-stickiness.md1.8 KB · 5da208a3d5a7
- example-team-taxonomy.md842 B · 4ae2fa0bd492
- example-trends-breakdowns.md4.5 KB · 86d70de34425
- example-trends-unique-users.md3.8 KB · 9813bdbd2b9b
- example-web-overview.md1.5 KB · 2e41251b2652
- example-web-path-stats.md3.3 KB · 83aa58b06ff7
- example-web-traffic-by-device-type.md1.4 KB · db4daba53efe
- example-web-traffic-channels.md1.5 KB · f3603159f550
- guidelines.md22 KB · 6aaba982ee32
- hogql-extensions.md5.9 KB · 53c877d1ad12
- models-actions.md2.4 KB · cbcb8e905b77
- models-activity-logs.md2.7 KB · a7f161d6d23e
- models-ai-observability-evaluations.md3.0 KB · e5ddefcce1e8
- models-ai-observability-events.md3.4 KB · 2157c278ef92
- models-ai-observability-reviews.md7.8 KB · 4cbed04b328d
- models-alerts.md2.4 KB · 9f0d1f869ea2
- models-annotations.md2.3 KB · a1fd95cc25f6
- models-apm-spans.md8.5 KB · 325b2bd37783
- models-autoresearch.md1.7 KB · 239066248bc0
- models-batch-exports.md5.1 KB · 334ca3472fef
- models-cohorts.md5.5 KB · 10b954cbdc3f
- models-customer-analytics.md18 KB · 7fd8309a9b38
- models-customer-tasks.md1.1 KB · 35c180e0f313
- models-dashboards-insights.md2.5 KB · f44892c2de3e
- models-data-warehouse.md9.9 KB · e290cdcb3a7e
- models-datasets.md5.8 KB · e9515e14bad9
- models-early-access-features.md2.5 KB · 3631fb28f24f
- models-endpoints.md3.2 KB · 4eadb225ca67
- models-error-tracking.md5.8 KB · 984b7b1c4448
- models-flags-experiments.md4.1 KB · 35cbf94ede0a
- models-heatmaps.md3.1 KB · 41eff193b908
- models-hog-flows.md2.0 KB · f12be06a649d
- models-hog-functions.md2.9 KB · b0d191a52a4c
- models-integrations.md2.6 KB · 1f0236d91d87
- models-logs.md15 KB · 188a56fcbb76
- models-mcp.md37 KB · 6d4d1dbf1907
- models-messaging-opt-outs.md2.9 KB · c61881f6dae6
- models-metrics.md10 KB · 482e1facf955
- models-notebooks.md3.2 KB · e1bac160639e
- models-replay-vision.md2.9 KB · 70563dd3cbc1
- models-session-recording-playlists.md2.0 KB · e7932a7ade9c
- models-session-recordings.md2.4 KB · 034fc1d0d56c
- models-support-tickets.md2.9 KB · 2ddf1b905a69
- models-surveys.md2.6 KB · 8643495082c5
- models-usage-metrics.md3.0 KB · 3d21f93236c8
- models-variables.md3.7 KB · 3ab59c7192dc
- person-property-modes.md2.5 KB · 283bae174ed0
- taxonomy-dynamic-properties.md2.8 KB · f490ea453a2d
- taxonomy-skipped-events.md1.1 KB · 509f49b1b801
65 files, 320 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.
Skill folder on GitHub at e0fbf5eMore from PostHog
analyzing-experiment-session-replays
This skill enables agents to analyze session recordings from experiment variants to identify behavioral differences between control and test groups.
Claude Code, Codex, Cursor +4 · about 2.3K tokens · pinned 7 days ago
analyzing-offline-evaluations
This skill inspects and compares offline AI evaluation experiments stored in PostHog, diagnoses case-level regressions, and tracks scorer changes across…
Claude Code, Codex, Cursor +4 · about 1.5K tokens · pinned 7 days ago
auditing-warehouse-view-health
Audits materialized views in a PostHog data warehouse to identify failed views and flag unused ones that waste compute resources.
Claude Code, Codex, Cursor +4 · about 1.4K tokens · pinned 7 days ago
authoring-data-quality-checks
This skill adds data quality checks (like dbt tests) on warehouse tables, views, and HogQL metrics, supporting assertions such as not-null, uniqueness…
Claude Code, Codex, Cursor +4 · about 2.5K tokens · pinned 7 days ago
authoring-scouts
This skill helps engineers write, edit, and adapt PostHog Signals scouts, scheduled agents that scan projects and report findings to an inbox.
Claude Code, Codex, Cursor +4 · about 10.6K tokens · pinned 7 days ago
building-a-dashboard
This skill constructs or modifies PostHog dashboards by selecting and arranging insight tiles.
Claude Code, Codex, Cursor +4 · about 2.1K tokens · pinned 7 days ago
Related in Data and databases
configuring-experiment-analytics
Configures how PostHog measures experiment impact by setting exposure criteria (who counts in the analysis), choosing metrics to track (mean, funnel, ratio…
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 3.4K tokens · pinned 7 days ago
configuring-experiment-rollout
Configures variant split and overall rollout percentage for PostHog experiments, determining who sees which test variant and what percentage of users enter…
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 3.6K tokens · pinned 7 days ago
diagnosing-experiment-health
This skill diagnoses problems with a PostHog experiment's setup, exposures, results, and changes during its run.
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 5.6K tokens · pinned 7 days ago
modeling-dimension-tables
This skill builds reusable lookup tables (dimensions) like country, plan, and date for star-schema analytics on PostHog or dbt.
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 1.1K tokens · pinned 7 days ago
modeling-product-usage-metrics
This skill helps build reusable product engagement models, retention, stickiness, and lifecycle, using either PostHog HogQL or dbt.
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 1.1K tokens · pinned 7 days ago
modeling-revenue-metrics
Build revenue models for MRR, ARR, gross revenue, churn, ARPU, and LTV on PostHog managed revenue views or dbt marts.
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 1.8K tokens · pinned 7 days ago