User Deep Dive
PostHogOfficialPublished by PostHog
- Skill
- Research and analysis
- Data and AI
- MIT
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a comprehensive deep dive into a specific user's activity within PostHog. By querying event logs and cross-referencing with CRM data from Vitally, it builds a detailed profile of how a user interacts with the platform. It covers activity patterns, session replays, AI tool usage, and error tracking interactions, culminating in an executive summary designed to prepare team members for direct user outreach.
What it does
- Prompts for a specific time window to scope the analysis.
- Runs parallel SQL queries against PostHog event data to identify key behaviors.
- Integrates CRM data from Vitally to provide professional context like role and account.
- Summarizes usage of specific product areas such as session replays, error tracking, and AI features.
- Generates an executive summary and actionable outreach angles based on observed patterns.
- Provides direct links to filtered session replays for the specific user.
When to use it
- Before conducting a customer success or support call with a specific user.
- When evaluating how a power user is leveraging different PostHog features.
- To identify potential pain points or gaps in a user's product adoption.
- When preparing for account reviews or renewal discussions.
Advantages
- Consolidates disparate data points into a single, cohesive user profile.
- Saves time by executing multiple analytical queries in parallel.
- Provides context-aware outreach suggestions based on actual product usage.
- Helps distinguish between active builders and passive consumers of data.
Usage examples
- “Deep dive on user [email removed] for the last 30 days.”
- The agent will query PostHog for activity over the last month, fetch CRM details from Vitally, and produce a report summarizing the user's engagement, AI usage, and recommended talking points.
- “Run a user deep dive for [email removed].”
- The agent will first ask for a time window, then proceed to analyze the user's event history, session replays, and feature adoption to generate a comprehensive briefing document.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/posthog/user-deep-dive/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip user-deep-dive.zip -d .agents/skills
Documentation by PostHog
Deep dive on a PostHog user by email address. Analyse what they do, where they spend time, and what products they use.
Input: $ARGUMENTS (email address, e.g. [email protected])
Process
Step 0: Ask for time window
Before running any queries, ask the user:
"What time window would you like to analyse? (default: last 14 days)"
If they don't respond or say "default", use 14 days. Use their answer to set {days} in all queries below.
Step 1: Run queries in parallel
Run all of the following queries simultaneously via the query-run MCP tool.
1. Activity overview — event breakdown (excluding PostHog internals):
SELECT event, count() as cnt
FROM events
WHERE person.properties.email = '{email}'
AND timestamp >= now() - interval {days} day
AND event NOT IN (
'$feature_flag_called',
'$ai_span',
'$ai_trace',
'$autocapture',
'$web_vitals',
'react_framerate',
'spinner_unloaded',
'replay_parse_timing',
'$dead_click'
)
GROUP BY event
ORDER BY cnt DESC
LIMIT 302. Page views — where they spend their time:
SELECT properties.$current_url as url, count() as cnt
FROM events
WHERE person.properties.email = '{email}'
AND event = '$pageview'
AND timestamp >= now() - interval {days} day
GROUP BY url
ORDER BY cnt DESC
LIMIT 253. Insight details — which insights/dashboards they view:
SELECT properties.insight as insight_type, properties.insight_name as name, count() as views
FROM events
WHERE person.properties.email = '{email}'
AND event = 'insight viewed'
AND timestamp >= now() - interval {days} day
GROUP BY insight_type, name
ORDER BY views DESC
LIMIT 204. Session replay views — replays they've watched:
SELECT
properties.session_id as session_id,
properties.$current_url as url,
timestamp
FROM events
WHERE person.properties.email = '{email}'
AND event = '$recording_viewed'
AND timestamp >= now() - interval {days} day
ORDER BY timestamp DESC
LIMIT 205. Error tracking usage — how they interact with error tracking in PostHog:
SELECT event, properties.issue_id as issue_id, properties.issue_name as issue_name, count() as cnt
FROM events
WHERE person.properties.email = '{email}'
AND event IN ('error tracking issue viewed', 'error tracking issue resolved', 'error tracking issue assigned', 'error tracking issue suppressed', 'error tracking list viewed')
AND timestamp >= now() - interval {days} day
GROUP BY event, issue_id, issue_name
ORDER BY cnt DESC
LIMIT 206. PostHog AI usage — Max and insight analysis counts:
SELECT event, count() as cnt
FROM events
WHERE person.properties.email = '{email}'
AND event IN ('$ai_generation', '$conversations_loaded', 'insight analyzed', 'chat with data opened')
AND timestamp >= now() - interval {days} day
GROUP BY event
ORDER BY cnt DESC7. Where they open Max — which pages/contexts they use Max on:
SELECT
properties.$current_url as url,
count() as cnt
FROM events
WHERE person.properties.email = '{email}'
AND event = '$conversations_loaded'
AND timestamp >= now() - interval {days} day
AND properties.$current_url LIKE '%posthog.com/project%'
GROUP BY url
ORDER BY cnt DESC
LIMIT 20Step 2: Cross-reference with Vitally
Use Vitally tools to look up the user by email — get their role, title, account name, and any CRM data available.
Output Format
Executive Summary
2–3 sentences capturing who this person is, what they primarily use PostHog for, and the single most interesting or actionable thing about their usage. Write it as if briefing someone before a call with this user.
Profile
Name, email, role/title, LinkedIn (if available)
Location (from timezone or geo data)
Account they belong to
Activity Summary (last {days} days)
Total events, key event types
How many queries run, insights viewed, dashboards checked, exports done
Where They Spend Time
Which PostHog projects (extract project IDs from URLs)
Which product areas (analytics, replay, flags, LLM analytics, data management, error tracking, etc.)
Specific dashboards or insights they revisit
What They're Doing
Interpret the insight names and patterns — what business questions are they answering?
Are they building things (creating insights, actions, destinations) or consuming (viewing dashboards, exporting)?
Error tracking: are they actively triaging errors (resolving, assigning, suppressing) or just browsing?
Session Recordings
Link directly to PostHog session replay filtered to this user:
https://us.posthog.com/replay?filters={"type":"AND","values":[{"type":"AND","values":[{"key":"email","value":["{email}"],"operator":"exact","type":"person"}]}]}Summarise any patterns from the replays they've watched (query 4): which parts of the product, how recently
PostHog AI Usage
How often do they open Max (
$conversations_loadedcount) and make AI calls ($ai_generationcount)?Do they use insight analysis (
insight analyzed)?Where do they open Max? — Summarise the URLs from query 7. Extract the product area from each URL (e.g.
/dashboard/→ "dashboards",/sql→ "SQL editor",/insights/→ "insights",/persons/→ "person profiles") and list the top contexts with counts. This tells us what they're trying to get help with.Are they looking at LLM Analytics?
Outreach Angles
Based on their usage, suggest 2-3 conversation starters for the user's outreach
Flag any pain points (query failures, rage clicks, error tracking spikes, etc.)
Note any products they're NOT using that would be relevant
Important
Ask for the time window before running any queries.
Use the PostHog MCP
query-runtool, NOT curl. Fall back to curl only if MCP is unavailable.Vitally
lastSeenTimestampdata is stale — do NOT rely on it for activity. Always use PostHog event data.Run all PostHog queries in parallel to save time.
If PostHog returns 503 (busy), wait a moment and retry once before giving up on that query.
The session replay link should use the user's actual email in the filter parameter.
Files
- ATTRIBUTION.mdAdded by AutoGineer861 B
- LICENSELicence file added by AutoGineer1.0 KiB
- README.md2.9 KiB
- SKILL.md6.2 KiB
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Published by
- PostHog
- Publisher
- PostHog (Official)
- Source
- PostHog/skills · skills/team/customer-success/user-deep-dive · commit a5d30e7
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by PostHog or PostHog.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download user-deep-dive.zip