posthog-session-replay-diagnosis

Diagnose missing or broken PostHog session replay recordings across web and mobile platforms.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mongo-ai/posthog-triage-agent --skill posthog-session-replay-diagnosis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: posthog-session-replay-diagnosis
Source: https://github.com/mongo-ai/posthog-triage-agent/tree/main/.claude/skills/posthog-session-replay-diagnosis
Command: npx skills add https://github.com/mongo-ai/posthog-triage-agent --skill posthog-session-replay-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Support engineers struggle to pinpoint why PostHog session replay recordings are missing, broken, or show performance issues, leading to wasted time and delayed responses.

Core Features & Use Cases

  • Platform classification: Determines whether the issue is web or mobile and routes to the appropriate workflow.
  • Web replay diagnostics: Checks SDK version, capture vs playback problems, CSP/CORS, reverse proxy, and filtering expectations.
  • Mobile replay diagnostics: Handles performance/OOM, missing recordings, masking, and visual quality issues across iOS, Android, and Flutter.
  • Automated reference fetching: Runs parallel docs-search and GitHub issue searches to surface up‑to‑date guidance.
  • Escalation guidance: Provides clear criteria for when to involve engineering.

Quick Start

Ask the agent to diagnose the session replay problem for ticket #12345 on the web platform.

Frequently Asked Questions about posthog-session-replay-diagnosis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why are my PostHog session replay recordings missing or broken?

PostHog session replay recordings can be missing or broken due to incorrect SDK versions, configuration errors, or network restrictions like CSP and CORS policies. Diagnosing these issues involves checking SDK setup, proxy settings, and filtering expectations to identify the root cause.

How do I diagnose PostHog session replay performance issues on mobile?

To diagnose mobile session replay performance issues, analyze SDK performance metrics, memory usage causing OOM, and visual quality problems across iOS, Android, and Flutter. This skill routes mobile issues to a specific workflow checking masking configurations and performance bottlenecks.

Does PostHog session replay work with reverse proxy and CSP configurations?

PostHog session replay works with reverse proxy and CSP configurations, but improper settings can block capture or playback. This skill verifies your web platform's CSP, CORS headers, and reverse proxy settings to ensure recordings function correctly without network restrictions.

What is the best way to troubleshoot PostHog session replay capture problems?

The best way to troubleshoot PostHog session replay capture problems is to verify your SDK version and distinguish between capture and playback failures. This skill runs parallel documentation and GitHub issue searches to surface up-to-date guidance for resolving capture discrepancies.

When should I escalate PostHog session replay issues to engineering?

You should escalate PostHog session replay issues to engineering when diagnostics confirm the problem persists after ruling out SDK version, configuration, CSP/CORS, and proxy issues. This skill provides clear escalation criteria once standard troubleshooting steps are exhausted.