About query-examples
query-examples is a reference skill for querying PostHog data. It combines core data-schema guidance, HogQL references, and example analytics queries across product, web, session, and error data.
Key features
- 01PostHog core data-schema reference
- 02HogQL functions and syntax guidance
- 03Analytics query examples across domains
- 04LLM trace and session analysis examples
Use cases
- 01Build trends, funnels, and retention queries
- 02Inspect web traffic and user paths
- 03Query errors, logs, and session recordings
MCP support
The skill provides guidance for querying PostHog when an MCP server does not supply its own instructions.
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ posthog/ ai-plugin --skill query-examplesAfter installing, type/query-examplesin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/available-functions.mdexample-error-tracking.mdexample-event-taxonomy.mdexample-funnel-breakdown.mdexample-funnel-trends.mdexample-lifecycle.mdexample-llm-trace.mdexample-llm-traces-list.mdexample-logs.mdexample-paths.mdexample-person-property-taxonomy.mdexample-retention.mdexample-session-replay.mdexample-sessions.mdexample-stickiness.mdexample-team-taxonomy.mdexample-trends-breakdowns.mdexample-trends-unique-users.mdexample-web-overview.mdexample-web-path-stats.mdexample-web-traffic-by-device-type.mdexample-web-traffic-channels.mdguidelines.mdhogql-extensions.mdmodels-actions.mdmodels-activity-logs.mdmodels-alerts.mdmodels-annotations.mdmodels-batch-exports.mdmodels-cohorts.mdDetails
From the project READMEQuerying data in PostHog
If the MCP server haven't provided instructions on querying data in PostHog, read the guidelines.
Data Schema
Schema reference for PostHog's core system models, organized by domain:
- Activity logs
- Actions
- Alerts
- Annotations
- Batch exports
- Early Access Features
- Cohorts & Persons
- Dashboards, Tiles & Insights
- Data Warehouse
- Data Modeling Endpoints
- Error Tracking
- Flags & Experiments
- Hog Flows
- Hog Functions
- Integrations
- Logs
- Notebooks
- Session Recording Playlists
- Session Recordings
- Support Tickets
- Surveys
- SQL Variables
- Skipped events in the read-data-schema tool
- Dynamic person and event properties — patterns like
$survey_dismissed/{id},$feature/{key}that don't appear in tool results
HogQL References
- Person property modes (event-time vs query-time). Read when working with
person.properties.*to understand if values are historical or current. - Sparkline, SemVer, Session replays, Actions, Translation, HTML tags and links, Text effects, and more
- SQL variables.
- Available functions in HogQL. IMPORTANT: the list is long, so read data using bash commands like grep.
Analytics Query Examples
Use the examples below to create optimized analytical queries.
- Trends (unique users, specific time range, single series)
- Trends (total count with multiple breakdowns)
- Funnel (two steps, aggregated by unique users, broken down by the person's role, sequential, 14-day conversion window)
- Conversion trends (funnel, two steps, aggregated by unique groups, 1-day conversion window)
- Retention (unique users, returned to perform an event in the next 12 weeks, recurring)
- User paths (pageviews, three steps, applied path cleaning and filters, maximum 50 paths)
- Lifecycle (unique users by pageviews)
- Stickiness (counted by pageviews from unique users, defined by at least one event for the interval, non-cumulative)
- LLM trace (generations, spans, embeddings, human feedback, captured AI metrics)
- LLM traces list (searching and listing traces with property filters, two-phase query)
- Web path stats (paths, visitors, views, bounce rate)
- Web traffic channels (direct, organic search, etc)
- Web views by devices
- Web overview
- Error tracking (search for a value in an error and filtering by custom properties)
- Logs (filtering by severity and searching for a term)
- Sessions (listing sessions with duration, pageviews, and bounce rate)
- Session replay (listing recordings with activity filters)
- Team taxonomy (top events by count, paginated)
- Event taxonomy (properties of an event, with sample values)
- Person property taxonomy (sample values for person properties)
Comments
Markdown supported