About query-examples
A reference skill for querying data in PostHog, aimed at people building analytics queries. It organizes schema guidance, HogQL references, and examples spanning product analytics, sessions, errors, logs, and LLM traces.
Key features
- 01PostHog data schema reference
- 02HogQL function guidance
- 03Analytics query examples
- 04Examples across product and session data
- 05Error, log, and LLM trace queries
Use cases
- 01Building user trend or funnel queries
- 02Analyzing retention and user paths
- 03Querying session recordings and logs
- 04Exploring LLM generations and traces
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ posthog/ skills --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
- Usage Metrics
- 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