[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-posthog-diagnosing-missing-recordings":3,"mdc-9t588u-key":37,"related-repo-posthog-diagnosing-missing-recordings":1107,"related-org-posthog-diagnosing-missing-recordings":1210},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":26,"repoUrl":27,"updatedAt":28,"license":29,"forks":30,"topics":31,"repo":32,"sourceUrl":35,"mdContent":36},"diagnosing-missing-recordings","diagnose missing PostHog session recordings","Diagnoses why a session recording is missing or was not captured. Use when a user asks why a session has no replay, why recordings aren't appearing, or wants to troubleshoot session replay capture issues for a specific session ID or across their project. Covers SDK diagnostic signals, project settings, sampling, triggers, ad blockers, and quota\u002Fbilling scenarios.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"posthog","PostHog","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fposthog.png",[12,16,17,20,23],{"name":13,"slug":14,"type":15},"Observability","observability","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Analytics","analytics",{"name":21,"slug":22,"type":15},"Frontend","frontend",{"name":24,"slug":25,"type":15},"Debugging","debugging",56,"https:\u002F\u002Fgithub.com\u002FPostHog\u002Fskills","2026-04-22T05:06:51.989772",null,4,[],{"repoUrl":27,"stars":26,"forks":30,"topics":33,"description":34},[],"PostHog skills (under construction)","https:\u002F\u002Fgithub.com\u002FPostHog\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fomnibus\u002Fdiagnosing-missing-recordings","---\nname: diagnosing-missing-recordings\ndescription: >\n  Diagnoses why a session recording is missing or was not captured.\n  Use when a user asks why a session has no replay, why recordings aren't appearing,\n  or wants to troubleshoot session replay capture issues for a specific session ID\n  or across their project. Covers SDK diagnostic signals, project settings,\n  sampling, triggers, ad blockers, and quota\u002Fbilling scenarios.\n---\n\n# Diagnosing missing session recordings\n\nWhen a user asks \"why wasn't this session recorded?\" or \"why don't I have any recordings?\",\nfollow this workflow to systematically diagnose the cause.\n\n## Available tools\n\n| Tool                                    | Purpose                                               |\n| --------------------------------------- | ----------------------------------------------------- |\n| `posthog:execute-sql`                   | Query session event properties for diagnostic signals |\n| `posthog:session-recording-get`         | Check if a recording actually exists for the session  |\n| `posthog:query-session-recordings-list` | Search for recordings matching criteria               |\n\n## Diagnostic signals\n\nThe PostHog SDK emits diagnostic properties on every event that explain the recording state.\nSee the [diagnostic signals reference](.\u002Freferences\u002Fdiagnostic-signals.md) for the full list.\n\nThe key signals are:\n\n- `$has_recording` — whether PostHog has a stored recording for this session\n- `$recording_status` — SDK state: `active`, `buffering`, `disabled`, `sampled`, `paused`\n- `$session_recording_start_reason` — why recording started or didn't\n- `$sdk_debug_recording_script_not_loaded` — recorder script blocked (ad blocker)\n- `$sdk_debug_replay_*_trigger_status` — trigger states (URL, event, linked flag)\n- `$replay_sample_rate` — configured sample rate at capture time\n\n## Workflow\n\n### Step 1 — Check if the recording exists\n\nIf the user provides a session ID, first check whether a recording actually exists:\n\n```json\nposthog:session-recording-get\n{\n  \"id\": \"\u003Csession_id>\"\n}\n```\n\nIf this returns data, the recording exists — the issue is likely UI\u002Ffiltering, not capture.\nIf it returns 404, proceed to diagnose why.\n\n### Step 2 — Query diagnostic signals from events\n\nQuery the most recent event for the session to get SDK diagnostic properties:\n\n```sql\nposthog:execute-sql\nSELECT\n    properties.$has_recording AS has_recording,\n    properties.$recording_status AS recording_status,\n    properties.$session_recording_start_reason AS start_reason,\n    properties.$sdk_debug_recording_script_not_loaded AS script_not_loaded,\n    properties.$sdk_debug_replay_url_trigger_status AS url_trigger,\n    properties.$sdk_debug_replay_event_trigger_status AS event_trigger,\n    properties.$sdk_debug_replay_linked_flag_trigger_status AS flag_trigger,\n    properties.$replay_sample_rate AS sample_rate,\n    properties.$sdk_debug_replay_internal_buffer_length AS buffer_length,\n    properties.$sdk_debug_replay_flushed_size AS flushed_size,\n    properties.$lib AS sdk_library,\n    properties.$lib_version AS sdk_version\nFROM events\nWHERE $session_id = '\u003Csession_id>'\nORDER BY timestamp DESC\nLIMIT 1\n```\n\n### Step 3 — Diagnose the verdict\n\nUse the [diagnosis logic reference](.\u002Freferences\u002Fdiagnosis-logic.md) to interpret the signals.\nThe verdicts in priority order:\n\n1. **Recording exists** (`$has_recording = true`) — recording is captured, issue is elsewhere\n2. **Ad blocked (script)** (`$sdk_debug_recording_script_not_loaded = true`) — browser extension blocking the recorder script from loading\n3. **Disabled** (`$recording_status = 'disabled'`) — replay turned off in settings or SDK config\n4. **Trigger pending** (trigger statuses are `trigger_pending`, none matched) — recording gated on trigger that never fired\n5. **Sampled out** (`$session_recording_start_reason = 'sampled_out'`) — excluded by sample rate\n6. **Buffering empty** (`$recording_status = 'buffering'`, buffer length = 0, nothing flushed) — initialized but no snapshots produced\n7. **Flush blocked** (buffer length climbs across events while `flushed_size` stays at 0) — snapshots are produced but the `\u002Fs\u002F` ingestion endpoint is blocked by an ad blocker or misconfigured reverse proxy. Detecting this requires querying the trend across the session's events — see [example 3 in examples.md](.\u002Freferences\u002Fexamples.md)\n8. **Unknown** — signals don't match a known pattern\n\n### Step 4 — Check project-level settings (if no session ID)\n\nWhen the user asks about recordings missing project-wide (no specific session),\nquery for recent sessions to check the pattern:\n\n```sql\nposthog:execute-sql\nSELECT\n    $session_id,\n    properties.$recording_status AS recording_status,\n    properties.$session_recording_start_reason AS start_reason,\n    properties.$sdk_debug_recording_script_not_loaded AS script_not_loaded,\n    properties.$replay_sample_rate AS sample_rate\nFROM events\nWHERE event = '$pageview'\n    AND timestamp > now() - INTERVAL 1 DAY\nGROUP BY\n    $session_id,\n    recording_status,\n    start_reason,\n    script_not_loaded,\n    sample_rate\nORDER BY max(timestamp) DESC\nLIMIT 10\n```\n\nLook for patterns:\n\n- All `disabled` → replay is turned off in project settings\n- All `sampled_out` with low sample rate → sample rate too aggressive\n- All `script_not_loaded` → likely a CSP or deployment issue, not just one user's ad blocker\n- Mix of statuses → per-session issue, dig into specifics\n\n### Step 5 — Provide actionable recommendations\n\nBased on the verdict, recommend specific actions:\n\n| Verdict         | Recommendation                                                                                                                        |\n| --------------- | ------------------------------------------------------------------------------------------------------------------------------------- |\n| Ad blocked      | User's browser extension is blocking rrweb. Suggest trying without ad blocker, or using a proxy\u002Fcustom domain for the recorder script |\n| Disabled        | Check project replay settings — recording may be turned off. Link to Settings > Session replay                                        |\n| Trigger pending | The configured trigger (URL pattern, event, or feature flag) never matched. Review trigger configuration                              |\n| Sampled out     | Increase the sample rate in project settings, or use a trigger to guarantee capture for important sessions                            |\n| Buffering empty | Page closed before first snapshot. Common with very short sessions or single-page navigations. Consider lowering minimum duration     |\n| Unknown         | Direct user to troubleshooting docs: https:\u002F\u002Fposthog.com\u002Fdocs\u002Fsession-replay\u002Ftroubleshooting                                          |\n\n## Examples\n\nSee [real-world diagnostic examples](.\u002Freferences\u002Fexamples.md) showing how signal combinations\nmap to verdicts. Use these to calibrate your interpretation of query results.\n\n## Tips\n\n- If `$lib_version` is very old, some diagnostic signals won't be present.\n  Note this to the user — upgrading the SDK will provide better diagnostics.\n- A session might have events but no recording if the recording was deleted due to retention.\n  Check the session's timestamp against the project's retention period.\n- If `$has_recording` is true but the user can't find it, check if it's filtered out\n  by duration, activity threshold, or playlist filters.\n",{"data":38,"body":39},{"name":4,"description":6},{"type":40,"children":41},"root",[42,51,57,64,144,150,164,169,275,281,288,293,375,380,386,391,558,564,577,728,734,739,883,888,932,938,943,1045,1051,1063,1069,1101],{"type":43,"tag":44,"props":45,"children":47},"element","h1",{"id":46},"diagnosing-missing-session-recordings",[48],{"type":49,"value":50},"text","Diagnosing missing session recordings",{"type":43,"tag":52,"props":53,"children":54},"p",{},[55],{"type":49,"value":56},"When a user asks \"why wasn't this session recorded?\" or \"why don't I have any recordings?\",\nfollow this workflow to systematically diagnose the cause.",{"type":43,"tag":58,"props":59,"children":61},"h2",{"id":60},"available-tools",[62],{"type":49,"value":63},"Available tools",{"type":43,"tag":65,"props":66,"children":67},"table",{},[68,87],{"type":43,"tag":69,"props":70,"children":71},"thead",{},[72],{"type":43,"tag":73,"props":74,"children":75},"tr",{},[76,82],{"type":43,"tag":77,"props":78,"children":79},"th",{},[80],{"type":49,"value":81},"Tool",{"type":43,"tag":77,"props":83,"children":84},{},[85],{"type":49,"value":86},"Purpose",{"type":43,"tag":88,"props":89,"children":90},"tbody",{},[91,110,127],{"type":43,"tag":73,"props":92,"children":93},{},[94,105],{"type":43,"tag":95,"props":96,"children":97},"td",{},[98],{"type":43,"tag":99,"props":100,"children":102},"code",{"className":101},[],[103],{"type":49,"value":104},"posthog:execute-sql",{"type":43,"tag":95,"props":106,"children":107},{},[108],{"type":49,"value":109},"Query session event properties for diagnostic signals",{"type":43,"tag":73,"props":111,"children":112},{},[113,122],{"type":43,"tag":95,"props":114,"children":115},{},[116],{"type":43,"tag":99,"props":117,"children":119},{"className":118},[],[120],{"type":49,"value":121},"posthog:session-recording-get",{"type":43,"tag":95,"props":123,"children":124},{},[125],{"type":49,"value":126},"Check if a recording actually exists for the session",{"type":43,"tag":73,"props":128,"children":129},{},[130,139],{"type":43,"tag":95,"props":131,"children":132},{},[133],{"type":43,"tag":99,"props":134,"children":136},{"className":135},[],[137],{"type":49,"value":138},"posthog:query-session-recordings-list",{"type":43,"tag":95,"props":140,"children":141},{},[142],{"type":49,"value":143},"Search for recordings matching criteria",{"type":43,"tag":58,"props":145,"children":147},{"id":146},"diagnostic-signals",[148],{"type":49,"value":149},"Diagnostic signals",{"type":43,"tag":52,"props":151,"children":152},{},[153,155,162],{"type":49,"value":154},"The PostHog SDK emits diagnostic properties on every event that explain the recording state.\nSee the ",{"type":43,"tag":156,"props":157,"children":159},"a",{"href":158},".\u002Freferences\u002Fdiagnostic-signals.md",[160],{"type":49,"value":161},"diagnostic signals reference",{"type":49,"value":163}," for the full list.",{"type":43,"tag":52,"props":165,"children":166},{},[167],{"type":49,"value":168},"The key signals are:",{"type":43,"tag":170,"props":171,"children":172},"ul",{},[173,185,231,242,253,264],{"type":43,"tag":174,"props":175,"children":176},"li",{},[177,183],{"type":43,"tag":99,"props":178,"children":180},{"className":179},[],[181],{"type":49,"value":182},"$has_recording",{"type":49,"value":184}," — whether PostHog has a stored recording for this session",{"type":43,"tag":174,"props":186,"children":187},{},[188,194,196,202,204,210,211,217,218,224,225],{"type":43,"tag":99,"props":189,"children":191},{"className":190},[],[192],{"type":49,"value":193},"$recording_status",{"type":49,"value":195}," — SDK state: ",{"type":43,"tag":99,"props":197,"children":199},{"className":198},[],[200],{"type":49,"value":201},"active",{"type":49,"value":203},", ",{"type":43,"tag":99,"props":205,"children":207},{"className":206},[],[208],{"type":49,"value":209},"buffering",{"type":49,"value":203},{"type":43,"tag":99,"props":212,"children":214},{"className":213},[],[215],{"type":49,"value":216},"disabled",{"type":49,"value":203},{"type":43,"tag":99,"props":219,"children":221},{"className":220},[],[222],{"type":49,"value":223},"sampled",{"type":49,"value":203},{"type":43,"tag":99,"props":226,"children":228},{"className":227},[],[229],{"type":49,"value":230},"paused",{"type":43,"tag":174,"props":232,"children":233},{},[234,240],{"type":43,"tag":99,"props":235,"children":237},{"className":236},[],[238],{"type":49,"value":239},"$session_recording_start_reason",{"type":49,"value":241}," — why recording started or didn't",{"type":43,"tag":174,"props":243,"children":244},{},[245,251],{"type":43,"tag":99,"props":246,"children":248},{"className":247},[],[249],{"type":49,"value":250},"$sdk_debug_recording_script_not_loaded",{"type":49,"value":252}," — recorder script blocked (ad blocker)",{"type":43,"tag":174,"props":254,"children":255},{},[256,262],{"type":43,"tag":99,"props":257,"children":259},{"className":258},[],[260],{"type":49,"value":261},"$sdk_debug_replay_*_trigger_status",{"type":49,"value":263}," — trigger states (URL, event, linked flag)",{"type":43,"tag":174,"props":265,"children":266},{},[267,273],{"type":43,"tag":99,"props":268,"children":270},{"className":269},[],[271],{"type":49,"value":272},"$replay_sample_rate",{"type":49,"value":274}," — configured sample rate at capture time",{"type":43,"tag":58,"props":276,"children":278},{"id":277},"workflow",[279],{"type":49,"value":280},"Workflow",{"type":43,"tag":282,"props":283,"children":285},"h3",{"id":284},"step-1-check-if-the-recording-exists",[286],{"type":49,"value":287},"Step 1 — Check if the recording exists",{"type":43,"tag":52,"props":289,"children":290},{},[291],{"type":49,"value":292},"If the user provides a session ID, first check whether a recording actually exists:",{"type":43,"tag":294,"props":295,"children":300},"pre",{"className":296,"code":297,"language":298,"meta":299,"style":299},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","posthog:session-recording-get\n{\n  \"id\": \"\u003Csession_id>\"\n}\n","json","",[301],{"type":43,"tag":99,"props":302,"children":303},{"__ignoreMap":299},[304,316,326,367],{"type":43,"tag":305,"props":306,"children":309},"span",{"class":307,"line":308},"line",1,[310],{"type":43,"tag":305,"props":311,"children":313},{"style":312},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[314],{"type":49,"value":315},"posthog:session-recording-get\n",{"type":43,"tag":305,"props":317,"children":319},{"class":307,"line":318},2,[320],{"type":43,"tag":305,"props":321,"children":323},{"style":322},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[324],{"type":49,"value":325},"{\n",{"type":43,"tag":305,"props":327,"children":329},{"class":307,"line":328},3,[330,335,341,346,351,356,362],{"type":43,"tag":305,"props":331,"children":332},{"style":322},[333],{"type":49,"value":334},"  \"",{"type":43,"tag":305,"props":336,"children":338},{"style":337},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[339],{"type":49,"value":340},"id",{"type":43,"tag":305,"props":342,"children":343},{"style":322},[344],{"type":49,"value":345},"\"",{"type":43,"tag":305,"props":347,"children":348},{"style":322},[349],{"type":49,"value":350},":",{"type":43,"tag":305,"props":352,"children":353},{"style":322},[354],{"type":49,"value":355}," \"",{"type":43,"tag":305,"props":357,"children":359},{"style":358},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[360],{"type":49,"value":361},"\u003Csession_id>",{"type":43,"tag":305,"props":363,"children":364},{"style":322},[365],{"type":49,"value":366},"\"\n",{"type":43,"tag":305,"props":368,"children":369},{"class":307,"line":30},[370],{"type":43,"tag":305,"props":371,"children":372},{"style":322},[373],{"type":49,"value":374},"}\n",{"type":43,"tag":52,"props":376,"children":377},{},[378],{"type":49,"value":379},"If this returns data, the recording exists — the issue is likely UI\u002Ffiltering, not capture.\nIf it returns 404, proceed to diagnose why.",{"type":43,"tag":282,"props":381,"children":383},{"id":382},"step-2-query-diagnostic-signals-from-events",[384],{"type":49,"value":385},"Step 2 — Query diagnostic signals from events",{"type":43,"tag":52,"props":387,"children":388},{},[389],{"type":49,"value":390},"Query the most recent event for the session to get SDK diagnostic properties:",{"type":43,"tag":294,"props":392,"children":396},{"className":393,"code":394,"language":395,"meta":299,"style":299},"language-sql shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","posthog:execute-sql\nSELECT\n    properties.$has_recording AS has_recording,\n    properties.$recording_status AS recording_status,\n    properties.$session_recording_start_reason AS start_reason,\n    properties.$sdk_debug_recording_script_not_loaded AS script_not_loaded,\n    properties.$sdk_debug_replay_url_trigger_status AS url_trigger,\n    properties.$sdk_debug_replay_event_trigger_status AS event_trigger,\n    properties.$sdk_debug_replay_linked_flag_trigger_status AS flag_trigger,\n    properties.$replay_sample_rate AS sample_rate,\n    properties.$sdk_debug_replay_internal_buffer_length AS buffer_length,\n    properties.$sdk_debug_replay_flushed_size AS flushed_size,\n    properties.$lib AS sdk_library,\n    properties.$lib_version AS sdk_version\nFROM events\nWHERE $session_id = '\u003Csession_id>'\nORDER BY timestamp DESC\nLIMIT 1\n","sql",[397],{"type":43,"tag":99,"props":398,"children":399},{"__ignoreMap":299},[400,408,416,424,432,441,450,459,468,477,486,495,504,513,522,531,540,549],{"type":43,"tag":305,"props":401,"children":402},{"class":307,"line":308},[403],{"type":43,"tag":305,"props":404,"children":405},{},[406],{"type":49,"value":407},"posthog:execute-sql\n",{"type":43,"tag":305,"props":409,"children":410},{"class":307,"line":318},[411],{"type":43,"tag":305,"props":412,"children":413},{},[414],{"type":49,"value":415},"SELECT\n",{"type":43,"tag":305,"props":417,"children":418},{"class":307,"line":328},[419],{"type":43,"tag":305,"props":420,"children":421},{},[422],{"type":49,"value":423},"    properties.$has_recording AS has_recording,\n",{"type":43,"tag":305,"props":425,"children":426},{"class":307,"line":30},[427],{"type":43,"tag":305,"props":428,"children":429},{},[430],{"type":49,"value":431},"    properties.$recording_status AS recording_status,\n",{"type":43,"tag":305,"props":433,"children":435},{"class":307,"line":434},5,[436],{"type":43,"tag":305,"props":437,"children":438},{},[439],{"type":49,"value":440},"    properties.$session_recording_start_reason AS start_reason,\n",{"type":43,"tag":305,"props":442,"children":444},{"class":307,"line":443},6,[445],{"type":43,"tag":305,"props":446,"children":447},{},[448],{"type":49,"value":449},"    properties.$sdk_debug_recording_script_not_loaded AS script_not_loaded,\n",{"type":43,"tag":305,"props":451,"children":453},{"class":307,"line":452},7,[454],{"type":43,"tag":305,"props":455,"children":456},{},[457],{"type":49,"value":458},"    properties.$sdk_debug_replay_url_trigger_status AS url_trigger,\n",{"type":43,"tag":305,"props":460,"children":462},{"class":307,"line":461},8,[463],{"type":43,"tag":305,"props":464,"children":465},{},[466],{"type":49,"value":467},"    properties.$sdk_debug_replay_event_trigger_status AS event_trigger,\n",{"type":43,"tag":305,"props":469,"children":471},{"class":307,"line":470},9,[472],{"type":43,"tag":305,"props":473,"children":474},{},[475],{"type":49,"value":476},"    properties.$sdk_debug_replay_linked_flag_trigger_status AS flag_trigger,\n",{"type":43,"tag":305,"props":478,"children":480},{"class":307,"line":479},10,[481],{"type":43,"tag":305,"props":482,"children":483},{},[484],{"type":49,"value":485},"    properties.$replay_sample_rate AS sample_rate,\n",{"type":43,"tag":305,"props":487,"children":489},{"class":307,"line":488},11,[490],{"type":43,"tag":305,"props":491,"children":492},{},[493],{"type":49,"value":494},"    properties.$sdk_debug_replay_internal_buffer_length AS buffer_length,\n",{"type":43,"tag":305,"props":496,"children":498},{"class":307,"line":497},12,[499],{"type":43,"tag":305,"props":500,"children":501},{},[502],{"type":49,"value":503},"    properties.$sdk_debug_replay_flushed_size AS flushed_size,\n",{"type":43,"tag":305,"props":505,"children":507},{"class":307,"line":506},13,[508],{"type":43,"tag":305,"props":509,"children":510},{},[511],{"type":49,"value":512},"    properties.$lib AS sdk_library,\n",{"type":43,"tag":305,"props":514,"children":516},{"class":307,"line":515},14,[517],{"type":43,"tag":305,"props":518,"children":519},{},[520],{"type":49,"value":521},"    properties.$lib_version AS sdk_version\n",{"type":43,"tag":305,"props":523,"children":525},{"class":307,"line":524},15,[526],{"type":43,"tag":305,"props":527,"children":528},{},[529],{"type":49,"value":530},"FROM events\n",{"type":43,"tag":305,"props":532,"children":534},{"class":307,"line":533},16,[535],{"type":43,"tag":305,"props":536,"children":537},{},[538],{"type":49,"value":539},"WHERE $session_id = '\u003Csession_id>'\n",{"type":43,"tag":305,"props":541,"children":543},{"class":307,"line":542},17,[544],{"type":43,"tag":305,"props":545,"children":546},{},[547],{"type":49,"value":548},"ORDER BY timestamp DESC\n",{"type":43,"tag":305,"props":550,"children":552},{"class":307,"line":551},18,[553],{"type":43,"tag":305,"props":554,"children":555},{},[556],{"type":49,"value":557},"LIMIT 1\n",{"type":43,"tag":282,"props":559,"children":561},{"id":560},"step-3-diagnose-the-verdict",[562],{"type":49,"value":563},"Step 3 — Diagnose the verdict",{"type":43,"tag":52,"props":565,"children":566},{},[567,569,575],{"type":49,"value":568},"Use the ",{"type":43,"tag":156,"props":570,"children":572},{"href":571},".\u002Freferences\u002Fdiagnosis-logic.md",[573],{"type":49,"value":574},"diagnosis logic reference",{"type":49,"value":576}," to interpret the signals.\nThe verdicts in priority order:",{"type":43,"tag":578,"props":579,"children":580},"ol",{},[581,600,617,634,652,669,686,718],{"type":43,"tag":174,"props":582,"children":583},{},[584,590,592,598],{"type":43,"tag":585,"props":586,"children":587},"strong",{},[588],{"type":49,"value":589},"Recording exists",{"type":49,"value":591}," (",{"type":43,"tag":99,"props":593,"children":595},{"className":594},[],[596],{"type":49,"value":597},"$has_recording = true",{"type":49,"value":599},") — recording is captured, issue is elsewhere",{"type":43,"tag":174,"props":601,"children":602},{},[603,608,609,615],{"type":43,"tag":585,"props":604,"children":605},{},[606],{"type":49,"value":607},"Ad blocked (script)",{"type":49,"value":591},{"type":43,"tag":99,"props":610,"children":612},{"className":611},[],[613],{"type":49,"value":614},"$sdk_debug_recording_script_not_loaded = true",{"type":49,"value":616},") — browser extension blocking the recorder script from loading",{"type":43,"tag":174,"props":618,"children":619},{},[620,625,626,632],{"type":43,"tag":585,"props":621,"children":622},{},[623],{"type":49,"value":624},"Disabled",{"type":49,"value":591},{"type":43,"tag":99,"props":627,"children":629},{"className":628},[],[630],{"type":49,"value":631},"$recording_status = 'disabled'",{"type":49,"value":633},") — replay turned off in settings or SDK config",{"type":43,"tag":174,"props":635,"children":636},{},[637,642,644,650],{"type":43,"tag":585,"props":638,"children":639},{},[640],{"type":49,"value":641},"Trigger pending",{"type":49,"value":643}," (trigger statuses are ",{"type":43,"tag":99,"props":645,"children":647},{"className":646},[],[648],{"type":49,"value":649},"trigger_pending",{"type":49,"value":651},", none matched) — recording gated on trigger that never fired",{"type":43,"tag":174,"props":653,"children":654},{},[655,660,661,667],{"type":43,"tag":585,"props":656,"children":657},{},[658],{"type":49,"value":659},"Sampled out",{"type":49,"value":591},{"type":43,"tag":99,"props":662,"children":664},{"className":663},[],[665],{"type":49,"value":666},"$session_recording_start_reason = 'sampled_out'",{"type":49,"value":668},") — excluded by sample rate",{"type":43,"tag":174,"props":670,"children":671},{},[672,677,678,684],{"type":43,"tag":585,"props":673,"children":674},{},[675],{"type":49,"value":676},"Buffering empty",{"type":49,"value":591},{"type":43,"tag":99,"props":679,"children":681},{"className":680},[],[682],{"type":49,"value":683},"$recording_status = 'buffering'",{"type":49,"value":685},", buffer length = 0, nothing flushed) — initialized but no snapshots produced",{"type":43,"tag":174,"props":687,"children":688},{},[689,694,696,702,704,710,712],{"type":43,"tag":585,"props":690,"children":691},{},[692],{"type":49,"value":693},"Flush blocked",{"type":49,"value":695}," (buffer length climbs across events while ",{"type":43,"tag":99,"props":697,"children":699},{"className":698},[],[700],{"type":49,"value":701},"flushed_size",{"type":49,"value":703}," stays at 0) — snapshots are produced but the ",{"type":43,"tag":99,"props":705,"children":707},{"className":706},[],[708],{"type":49,"value":709},"\u002Fs\u002F",{"type":49,"value":711}," ingestion endpoint is blocked by an ad blocker or misconfigured reverse proxy. Detecting this requires querying the trend across the session's events — see ",{"type":43,"tag":156,"props":713,"children":715},{"href":714},".\u002Freferences\u002Fexamples.md",[716],{"type":49,"value":717},"example 3 in examples.md",{"type":43,"tag":174,"props":719,"children":720},{},[721,726],{"type":43,"tag":585,"props":722,"children":723},{},[724],{"type":49,"value":725},"Unknown",{"type":49,"value":727}," — signals don't match a known pattern",{"type":43,"tag":282,"props":729,"children":731},{"id":730},"step-4-check-project-level-settings-if-no-session-id",[732],{"type":49,"value":733},"Step 4 — Check project-level settings (if no session ID)",{"type":43,"tag":52,"props":735,"children":736},{},[737],{"type":49,"value":738},"When the user asks about recordings missing project-wide (no specific session),\nquery for recent sessions to check the pattern:",{"type":43,"tag":294,"props":740,"children":742},{"className":393,"code":741,"language":395,"meta":299,"style":299},"posthog:execute-sql\nSELECT\n    $session_id,\n    properties.$recording_status AS recording_status,\n    properties.$session_recording_start_reason AS start_reason,\n    properties.$sdk_debug_recording_script_not_loaded AS script_not_loaded,\n    properties.$replay_sample_rate AS sample_rate\nFROM events\nWHERE event = '$pageview'\n    AND timestamp > now() - INTERVAL 1 DAY\nGROUP BY\n    $session_id,\n    recording_status,\n    start_reason,\n    script_not_loaded,\n    sample_rate\nORDER BY max(timestamp) DESC\nLIMIT 10\n",[743],{"type":43,"tag":99,"props":744,"children":745},{"__ignoreMap":299},[746,753,760,768,775,782,789,797,804,812,820,828,835,843,851,859,867,875],{"type":43,"tag":305,"props":747,"children":748},{"class":307,"line":308},[749],{"type":43,"tag":305,"props":750,"children":751},{},[752],{"type":49,"value":407},{"type":43,"tag":305,"props":754,"children":755},{"class":307,"line":318},[756],{"type":43,"tag":305,"props":757,"children":758},{},[759],{"type":49,"value":415},{"type":43,"tag":305,"props":761,"children":762},{"class":307,"line":328},[763],{"type":43,"tag":305,"props":764,"children":765},{},[766],{"type":49,"value":767},"    $session_id,\n",{"type":43,"tag":305,"props":769,"children":770},{"class":307,"line":30},[771],{"type":43,"tag":305,"props":772,"children":773},{},[774],{"type":49,"value":431},{"type":43,"tag":305,"props":776,"children":777},{"class":307,"line":434},[778],{"type":43,"tag":305,"props":779,"children":780},{},[781],{"type":49,"value":440},{"type":43,"tag":305,"props":783,"children":784},{"class":307,"line":443},[785],{"type":43,"tag":305,"props":786,"children":787},{},[788],{"type":49,"value":449},{"type":43,"tag":305,"props":790,"children":791},{"class":307,"line":452},[792],{"type":43,"tag":305,"props":793,"children":794},{},[795],{"type":49,"value":796},"    properties.$replay_sample_rate AS sample_rate\n",{"type":43,"tag":305,"props":798,"children":799},{"class":307,"line":461},[800],{"type":43,"tag":305,"props":801,"children":802},{},[803],{"type":49,"value":530},{"type":43,"tag":305,"props":805,"children":806},{"class":307,"line":470},[807],{"type":43,"tag":305,"props":808,"children":809},{},[810],{"type":49,"value":811},"WHERE event = '$pageview'\n",{"type":43,"tag":305,"props":813,"children":814},{"class":307,"line":479},[815],{"type":43,"tag":305,"props":816,"children":817},{},[818],{"type":49,"value":819},"    AND timestamp > now() - INTERVAL 1 DAY\n",{"type":43,"tag":305,"props":821,"children":822},{"class":307,"line":488},[823],{"type":43,"tag":305,"props":824,"children":825},{},[826],{"type":49,"value":827},"GROUP BY\n",{"type":43,"tag":305,"props":829,"children":830},{"class":307,"line":497},[831],{"type":43,"tag":305,"props":832,"children":833},{},[834],{"type":49,"value":767},{"type":43,"tag":305,"props":836,"children":837},{"class":307,"line":506},[838],{"type":43,"tag":305,"props":839,"children":840},{},[841],{"type":49,"value":842},"    recording_status,\n",{"type":43,"tag":305,"props":844,"children":845},{"class":307,"line":515},[846],{"type":43,"tag":305,"props":847,"children":848},{},[849],{"type":49,"value":850},"    start_reason,\n",{"type":43,"tag":305,"props":852,"children":853},{"class":307,"line":524},[854],{"type":43,"tag":305,"props":855,"children":856},{},[857],{"type":49,"value":858},"    script_not_loaded,\n",{"type":43,"tag":305,"props":860,"children":861},{"class":307,"line":533},[862],{"type":43,"tag":305,"props":863,"children":864},{},[865],{"type":49,"value":866},"    sample_rate\n",{"type":43,"tag":305,"props":868,"children":869},{"class":307,"line":542},[870],{"type":43,"tag":305,"props":871,"children":872},{},[873],{"type":49,"value":874},"ORDER BY max(timestamp) DESC\n",{"type":43,"tag":305,"props":876,"children":877},{"class":307,"line":551},[878],{"type":43,"tag":305,"props":879,"children":880},{},[881],{"type":49,"value":882},"LIMIT 10\n",{"type":43,"tag":52,"props":884,"children":885},{},[886],{"type":49,"value":887},"Look for patterns:",{"type":43,"tag":170,"props":889,"children":890},{},[891,903,915,927],{"type":43,"tag":174,"props":892,"children":893},{},[894,896,901],{"type":49,"value":895},"All ",{"type":43,"tag":99,"props":897,"children":899},{"className":898},[],[900],{"type":49,"value":216},{"type":49,"value":902}," → replay is turned off in project settings",{"type":43,"tag":174,"props":904,"children":905},{},[906,907,913],{"type":49,"value":895},{"type":43,"tag":99,"props":908,"children":910},{"className":909},[],[911],{"type":49,"value":912},"sampled_out",{"type":49,"value":914}," with low sample rate → sample rate too aggressive",{"type":43,"tag":174,"props":916,"children":917},{},[918,919,925],{"type":49,"value":895},{"type":43,"tag":99,"props":920,"children":922},{"className":921},[],[923],{"type":49,"value":924},"script_not_loaded",{"type":49,"value":926}," → likely a CSP or deployment issue, not just one user's ad blocker",{"type":43,"tag":174,"props":928,"children":929},{},[930],{"type":49,"value":931},"Mix of statuses → per-session issue, dig into specifics",{"type":43,"tag":282,"props":933,"children":935},{"id":934},"step-5-provide-actionable-recommendations",[936],{"type":49,"value":937},"Step 5 — Provide actionable recommendations",{"type":43,"tag":52,"props":939,"children":940},{},[941],{"type":49,"value":942},"Based on the verdict, recommend specific actions:",{"type":43,"tag":65,"props":944,"children":945},{},[946,962],{"type":43,"tag":69,"props":947,"children":948},{},[949],{"type":43,"tag":73,"props":950,"children":951},{},[952,957],{"type":43,"tag":77,"props":953,"children":954},{},[955],{"type":49,"value":956},"Verdict",{"type":43,"tag":77,"props":958,"children":959},{},[960],{"type":49,"value":961},"Recommendation",{"type":43,"tag":88,"props":963,"children":964},{},[965,978,990,1002,1014,1026],{"type":43,"tag":73,"props":966,"children":967},{},[968,973],{"type":43,"tag":95,"props":969,"children":970},{},[971],{"type":49,"value":972},"Ad blocked",{"type":43,"tag":95,"props":974,"children":975},{},[976],{"type":49,"value":977},"User's browser extension is blocking rrweb. Suggest trying without ad blocker, or using a proxy\u002Fcustom domain for the recorder script",{"type":43,"tag":73,"props":979,"children":980},{},[981,985],{"type":43,"tag":95,"props":982,"children":983},{},[984],{"type":49,"value":624},{"type":43,"tag":95,"props":986,"children":987},{},[988],{"type":49,"value":989},"Check project replay settings — recording may be turned off. Link to Settings > Session replay",{"type":43,"tag":73,"props":991,"children":992},{},[993,997],{"type":43,"tag":95,"props":994,"children":995},{},[996],{"type":49,"value":641},{"type":43,"tag":95,"props":998,"children":999},{},[1000],{"type":49,"value":1001},"The configured trigger (URL pattern, event, or feature flag) never matched. Review trigger configuration",{"type":43,"tag":73,"props":1003,"children":1004},{},[1005,1009],{"type":43,"tag":95,"props":1006,"children":1007},{},[1008],{"type":49,"value":659},{"type":43,"tag":95,"props":1010,"children":1011},{},[1012],{"type":49,"value":1013},"Increase the sample rate in project settings, or use a trigger to guarantee capture for important sessions",{"type":43,"tag":73,"props":1015,"children":1016},{},[1017,1021],{"type":43,"tag":95,"props":1018,"children":1019},{},[1020],{"type":49,"value":676},{"type":43,"tag":95,"props":1022,"children":1023},{},[1024],{"type":49,"value":1025},"Page closed before first snapshot. Common with very short sessions or single-page navigations. Consider lowering minimum duration",{"type":43,"tag":73,"props":1027,"children":1028},{},[1029,1033],{"type":43,"tag":95,"props":1030,"children":1031},{},[1032],{"type":49,"value":725},{"type":43,"tag":95,"props":1034,"children":1035},{},[1036,1038],{"type":49,"value":1037},"Direct user to troubleshooting docs: ",{"type":43,"tag":156,"props":1039,"children":1043},{"href":1040,"rel":1041},"https:\u002F\u002Fposthog.com\u002Fdocs\u002Fsession-replay\u002Ftroubleshooting",[1042],"nofollow",[1044],{"type":49,"value":1040},{"type":43,"tag":58,"props":1046,"children":1048},{"id":1047},"examples",[1049],{"type":49,"value":1050},"Examples",{"type":43,"tag":52,"props":1052,"children":1053},{},[1054,1056,1061],{"type":49,"value":1055},"See ",{"type":43,"tag":156,"props":1057,"children":1058},{"href":714},[1059],{"type":49,"value":1060},"real-world diagnostic examples",{"type":49,"value":1062}," showing how signal combinations\nmap to verdicts. Use these to calibrate your interpretation of query results.",{"type":43,"tag":58,"props":1064,"children":1066},{"id":1065},"tips",[1067],{"type":49,"value":1068},"Tips",{"type":43,"tag":170,"props":1070,"children":1071},{},[1072,1085,1090],{"type":43,"tag":174,"props":1073,"children":1074},{},[1075,1077,1083],{"type":49,"value":1076},"If ",{"type":43,"tag":99,"props":1078,"children":1080},{"className":1079},[],[1081],{"type":49,"value":1082},"$lib_version",{"type":49,"value":1084}," is very old, some diagnostic signals won't be present.\nNote this to the user — upgrading the SDK will provide better diagnostics.",{"type":43,"tag":174,"props":1086,"children":1087},{},[1088],{"type":49,"value":1089},"A session might have events but no recording if the recording was deleted due to retention.\nCheck the session's timestamp against the project's retention period.",{"type":43,"tag":174,"props":1091,"children":1092},{},[1093,1094,1099],{"type":49,"value":1076},{"type":43,"tag":99,"props":1095,"children":1097},{"className":1096},[],[1098],{"type":49,"value":182},{"type":49,"value":1100}," is true but the user can't find it, check if it's filtered out\nby duration, activity threshold, or playlist filters.",{"type":43,"tag":1102,"props":1103,"children":1104},"style",{},[1105],{"type":49,"value":1106},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1108,"total":1209},[1109,1126,1144,1158,1174,1182,1193],{"slug":1110,"name":1110,"fn":1111,"description":1112,"org":1113,"tags":1114,"stars":26,"repoUrl":27,"updatedAt":1125},"account-handover","draft sales account handover notes","Draft structured handover notes for transitioning a PostHog account from one TAM or CSM to another. Use this skill when a TAM needs to hand over an account, prepare a transition briefing, write handover notes, create an account summary for a new owner, or any request involving account transitions between TAMs or CSMs. Triggers on \"hand over this account\", \"transition account to\", \"draft handover notes\", \"account briefing for new TAM\", \"prepare account transition\", or when a TAM names an account and says they're leaving or reassigning it.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1115,1118,1121,1122],{"name":1116,"slug":1117,"type":15},"Communications","communications",{"name":1119,"slug":1120,"type":15},"CRM","crm",{"name":9,"slug":8,"type":15},{"name":1123,"slug":1124,"type":15},"Sales","sales","2026-04-16T05:13:00.172732",{"slug":1127,"name":1127,"fn":1128,"description":1129,"org":1130,"tags":1131,"stars":26,"repoUrl":27,"updatedAt":1143},"auditing-warehouse-data-health","audit PostHog data warehouse health","Audit the health of a PostHog project's data warehouse — find every broken or degraded pipeline item across sources, sync schemas, materialized views, batch exports, and transformations. Use when the user asks \"what's broken in my warehouse?\", \"give me a health check\", \"audit my data pipeline\", \"why are some dashboards stale?\", or wants a one-shot triage summary before deciding where to spend time. Produces a prioritized report of issues grouped by severity and type, with recommended next steps.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1132,1135,1138,1141,1142],{"name":1133,"slug":1134,"type":15},"Audit","audit",{"name":1136,"slug":1137,"type":15},"Data Engineering","data-engineering",{"name":1139,"slug":1140,"type":15},"Data Quality","data-quality",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-06-21T08:19:05.85849",{"slug":1145,"name":1145,"fn":1146,"description":1147,"org":1148,"tags":1149,"stars":26,"repoUrl":27,"updatedAt":1157},"copying-flags-across-projects","copy feature flags across PostHog projects","Copy a feature flag from one PostHog project to one or more target projects in the same organization. Use when the user wants to duplicate a flag, promote a flag from staging to production, sync flags across projects, or replicate a flag configuration in a different workspace. Covers cohort remapping, scheduled-change handling, encrypted payloads, and the safe defaults (disabled in target, no scheduled changes).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1150,1153,1156],{"name":1151,"slug":1152,"type":15},"Deployment","deployment",{"name":1154,"slug":1155,"type":15},"Feature Flags","feature-flags",{"name":9,"slug":8,"type":15},"2026-05-04T05:56:44.484909",{"slug":1159,"name":1159,"fn":1160,"description":1161,"org":1162,"tags":1163,"stars":26,"repoUrl":27,"updatedAt":1173},"diagnosing-experiment-results","diagnose PostHog experiment results and anomalies","Diagnoses bias, anomalies, and strange-looking results on a specific PostHog experiment. Covers empty \u002F 0-exposure experiments, sample ratio mismatch, identity fragmentation, multi-variant exposure, uneven-split exclusion bias, significance traps (peeking, A\u002FA, Bayesian vs Frequentist), PostHog-vs-SQL discrepancies, and surprises after mid-run edits. Symptom-driven dispatch to the right diagnostic.\nTRIGGER when: user asks 'is my experiment biased?' or 'why 0 exposures?', references the bias banner, says a variant looks strange \u002F wrong \u002F off, sees significance flipping, notices PostHog numbers disagreeing with their SQL, sees an A\u002FA test showing significance, or reports surprises after mid-run edits.\nDO NOT TRIGGER when: creating a new experiment (use creating-experiments), only configuring rollout (use configuring-experiment-rollout) or metrics (use configuring-experiment-analytics), or only asking lifecycle questions (use managing-experiment-lifecycle).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1164,1167,1168,1171,1172],{"name":1165,"slug":1166,"type":15},"A\u002FB Testing","a-b-testing",{"name":18,"slug":19,"type":15},{"name":1169,"slug":1170,"type":15},"Data Analysis","data-analysis",{"name":24,"slug":25,"type":15},{"name":9,"slug":8,"type":15},"2026-05-22T06:59:58.103867",{"slug":4,"name":4,"fn":5,"description":6,"org":1175,"tags":1176,"stars":26,"repoUrl":27,"updatedAt":28},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1177,1178,1179,1180,1181],{"name":18,"slug":19,"type":15},{"name":24,"slug":25,"type":15},{"name":21,"slug":22,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},{"slug":1183,"name":1183,"fn":1184,"description":1185,"org":1186,"tags":1187,"stars":26,"repoUrl":27,"updatedAt":1192},"diagnosing-sdk-health","diagnose PostHog SDK health","Diagnoses the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them. Use when a user asks about PostHog SDK versions, outdated SDKs, upgrade recommendations, \"SDK health\", \"SDK doctor\" (the former name), or when events or features seem off and it might be due to an old SDK.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1188,1189,1190,1191],{"name":18,"slug":19,"type":15},{"name":24,"slug":25,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-04-27T05:46:14.554016",{"slug":1194,"name":1194,"fn":1195,"description":1196,"org":1197,"tags":1198,"stars":26,"repoUrl":27,"updatedAt":1208},"error-tracking-android","track Android errors with PostHog","PostHog error tracking for Android",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1199,1202,1203,1206,1207],{"name":1200,"slug":1201,"type":15},"Android","android",{"name":24,"slug":25,"type":15},{"name":1204,"slug":1205,"type":15},"Mobile","mobile",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-04-06T18:46:26.982494",110,{"items":1211,"total":1374},[1212,1227,1237,1250,1263,1276,1292,1309,1321,1336,1346,1364],{"slug":1213,"name":1213,"fn":1214,"description":1215,"org":1216,"tags":1217,"stars":1224,"repoUrl":1225,"updatedAt":1226},"analyzing-expensive-users","analyze expensive users in AI observability","Analyze the most expensive users in AI observability and explain why they cost so much. Use when the user asks about top spenders, expensive users, per-user LLM cost, user-level cost drivers, or patterns behind high AI observability spend.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1218,1219,1222,1223],{"name":18,"slug":19,"type":15},{"name":1220,"slug":1221,"type":15},"Cost Optimization","cost-optimization",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},35568,"https:\u002F\u002Fgithub.com\u002FPostHog\u002Fposthog","2026-07-28T05:34:11.117757",{"slug":1228,"name":1228,"fn":1229,"description":1230,"org":1231,"tags":1232,"stars":1224,"repoUrl":1225,"updatedAt":1236},"auditing-endpoints","audit PostHog project endpoints","Audit every endpoint in a PostHog project for staleness, failed materialisations, and unused materialised versions. Use when the user asks \"what endpoints can I clean up?\", \"are any of my endpoints broken?\", \"which materialised versions are still being called?\", or wants a one-shot cleanup pass over the Endpoints product. Produces a prioritised report grouped by issue type, with recommended actions but does not modify anything without explicit confirmation.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1233,1234,1235],{"name":18,"slug":19,"type":15},{"name":1133,"slug":1134,"type":15},{"name":9,"slug":8,"type":15},"2026-06-08T08:08:33.693989",{"slug":1238,"name":1238,"fn":1239,"description":1240,"org":1241,"tags":1242,"stars":1224,"repoUrl":1225,"updatedAt":1249},"auditing-warehouse-source-health","audit PostHog data warehouse source health","Audit the health of a PostHog project's data warehouse sources and syncs — find every broken or degraded source connection, sync schema, and webhook channel. Use when the user asks \"why are my imports failing?\", \"what's broken with my sources?\", \"why is my warehouse data stale?\", or wants a one-shot triage of source\u002Fsync health before deciding where to dig in. Produces a prioritized report grouped by severity, with recommended next steps. For materialized-view health use `auditing-warehouse-view-health`; for a single failing sync use `diagnosing-failed-warehouse-syncs`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1243,1244,1247,1248],{"name":1133,"slug":1134,"type":15},{"name":1245,"slug":1246,"type":15},"Data Warehouse","data-warehouse",{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-06-18T08:22:57.67984",{"slug":1251,"name":1251,"fn":1252,"description":1253,"org":1254,"tags":1255,"stars":1224,"repoUrl":1225,"updatedAt":1262},"auditing-warehouse-view-health","audit PostHog materialized view health","Audit the health of a PostHog project's materialized views (saved queries) — find every failed materialization and flag unused or stale materialized views that cost storage and compute. Use when the user asks \"which of my views are broken?\", \"why is this materialized view failing?\", \"are any of my views wasting compute?\", or wants a one-shot triage of view health. For source\u002Fsync health use `auditing-warehouse-source-health`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1256,1257,1258,1261],{"name":1133,"slug":1134,"type":15},{"name":1245,"slug":1246,"type":15},{"name":1259,"slug":1260,"type":15},"Performance","performance",{"name":9,"slug":8,"type":15},"2026-06-18T08:25:10.936787",{"slug":1264,"name":1264,"fn":1265,"description":1266,"org":1267,"tags":1268,"stars":1224,"repoUrl":1225,"updatedAt":1275},"authoring-error-tracking-alerts","author PostHog error tracking alerts","Author error tracking alerts that fire when an issue is created, reopened, or starts spiking. Use when the user asks to set up error notifications, route exceptions to Slack\u002Fwebhook\u002FLinear, or evaluate which error events are worth alerting on. Covers trigger-event selection, integration choice, dedup against existing alerts, and shipping with the canonical message body shape.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1269,1272,1273,1274],{"name":1270,"slug":1271,"type":15},"Alerting","alerting",{"name":24,"slug":25,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-06-18T08:24:40.318583",{"slug":1277,"name":1277,"fn":1278,"description":1279,"org":1280,"tags":1281,"stars":1224,"repoUrl":1225,"updatedAt":1291},"authoring-log-alerts","author log alerts in PostHog","Author useful, low-noise log alerts on services in a PostHog project. Use when the user asks to set up alerts for their logs, suggest alerts they should add, or evaluate whether a service is worth monitoring. Covers service triage, baseline characterisation, threshold drafting, back-testing via simulate, and shipping with a notification destination.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1282,1283,1286,1287,1290],{"name":18,"slug":19,"type":15},{"name":1284,"slug":1285,"type":15},"Monitoring","monitoring",{"name":13,"slug":14,"type":15},{"name":1288,"slug":1289,"type":15},"Operations","operations",{"name":9,"slug":8,"type":15},"2026-07-18T05:10:54.430898",{"slug":1293,"name":1293,"fn":1294,"description":1295,"org":1296,"tags":1297,"stars":1224,"repoUrl":1225,"updatedAt":1308},"building-workflows","build and edit PostHog workflows","Build, edit, test, enable, and monitor PostHog workflows over MCP. Author the action\u002Fedge graph so it runs and opens cleanly in the visual editor, then change drafts surgically with patch operations. Use when asked to build, set up, automate, change, fix, or debug a workflow, campaign, broadcast, drip sequence, or event-triggered automation in the workflows product.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1298,1301,1304,1305],{"name":1299,"slug":1300,"type":15},"Automation","automation",{"name":1302,"slug":1303,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},{"name":1306,"slug":1307,"type":15},"Workflow Automation","workflow-automation","2026-07-28T05:34:12.167015",{"slug":1310,"name":1310,"fn":1311,"description":1312,"org":1313,"tags":1314,"stars":1224,"repoUrl":1225,"updatedAt":1320},"check-posthog-loading","inspect PostHog SDK loading across URLs","Inspect how the PostHog JavaScript SDK is loaded across a list of URLs. Use to confirm consistent installation across pages, find pages missing the snippet, detect mismatched API keys or hosts between pages, and verify the load method (head snippet vs deferred vs array.js).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1315,1316,1317,1318,1319],{"name":18,"slug":19,"type":15},{"name":24,"slug":25,"type":15},{"name":21,"slug":22,"type":15},{"name":13,"slug":14,"type":15},{"name":9,"slug":8,"type":15},"2026-05-07T05:56:19.828048",{"slug":1322,"name":1322,"fn":1323,"description":1324,"org":1325,"tags":1326,"stars":1224,"repoUrl":1225,"updatedAt":1335},"consuming-endpoints-from-client-code","integrate PostHog endpoints into client applications","Wire a PostHog endpoint into a client app or SDK. Covers fetching the OpenAPI spec, generating a typed client with openapi-generator or @hey-api\u002Fopenapi-ts, sending the right auth header, shaping the variables payload (HogQL code_name vs insight breakdown property), handling rate-limit and materialised-endpoint error responses. Use when the user says \"how do I call my endpoint\", \"generate a client for this\", or \"what auth header do I use\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1327,1330,1331,1332],{"name":1328,"slug":1329,"type":15},"API Development","api-development",{"name":21,"slug":22,"type":15},{"name":9,"slug":8,"type":15},{"name":1333,"slug":1334,"type":15},"SDK","sdk","2026-06-08T08:08:34.929454",{"slug":1337,"name":1337,"fn":1338,"description":1339,"org":1340,"tags":1341,"stars":1224,"repoUrl":1225,"updatedAt":1345},"copying-endpoints-across-projects","copy PostHog endpoints across projects","Copy a PostHog endpoint (a saved HogQL\u002Finsight query exposed as an API route) to another project in the same organization, or duplicate it under a new name in the same project. Use when the user wants to duplicate an endpoint, promote an endpoint from staging to production, replicate an endpoint's query\u002Fvariables\u002Ffreshness config in another workspace, or clone an endpoint to iterate on it. Unlike feature flags and experiments, endpoints have NO native cross-project copy tool — this skill covers the read-then-recreate flow (endpoint-get then endpoint-create), the active-project switching it requires, name-collision checks, and the safe defaults (land unmaterialised in the target, verify with endpoint-run). Does not cover editing endpoint versions (see managing-endpoint-versions) or authoring a brand-new endpoint from scratch (see creating-an-endpoint).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1342,1343,1344],{"name":1328,"slug":1329,"type":15},{"name":1288,"slug":1289,"type":15},{"name":9,"slug":8,"type":15},"2026-07-15T05:29:58.442727",{"slug":1347,"name":1347,"fn":1348,"description":1349,"org":1350,"tags":1351,"stars":1224,"repoUrl":1225,"updatedAt":1363},"creating-ai-subscription","schedule recurring AI-generated PostHog reports","Create a recurring AI-generated PostHog report — schedule a free-text prompt to run on a cron, with the LLM-synthesized markdown delivered to email or Slack on each tick. Use when the user wants a recurring AI summary of X on any cadence (daily, weekly, monthly, yearly) rather than a one-off report. (To attach an AI summary to an existing insight\u002Fdashboard subscription instead of a free-text prompt, see `managing-subscriptions` and its `summary_enabled` option.)\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1352,1353,1356,1357,1360],{"name":1299,"slug":1300,"type":15},{"name":1354,"slug":1355,"type":15},"Email","email",{"name":9,"slug":8,"type":15},{"name":1358,"slug":1359,"type":15},"Reporting","reporting",{"name":1361,"slug":1362,"type":15},"Slack","slack","2026-06-09T07:32:27.935712",{"slug":1365,"name":1365,"fn":1366,"description":1367,"org":1368,"tags":1369,"stars":1224,"repoUrl":1225,"updatedAt":1373},"creating-an-endpoint","create PostHog API endpoints","Create a PostHog endpoint with the right shape on the first try — covers query kind choice, name conventions, what to expose as variables (HogQL code_name vs insight breakdown), data_freshness_seconds, and whether to materialise on day one. Use when the user says \"create an endpoint\", \"expose this query as an API\", \"turn this insight into an endpoint\", or asks for help structuring a new endpoint. Steers away from common mistakes: materialising a query with cohort breakdowns or compare mode, inline-only variables on a materialised endpoint, unbounded date ranges, ambiguous names.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1370,1371,1372],{"name":18,"slug":19,"type":15},{"name":1328,"slug":1329,"type":15},{"name":9,"slug":8,"type":15},"2026-06-08T08:08:29.624498",231]