posthog-feature-flag-diagnosis

Diagnose PostHog feature flag evaluation failures and misconfigurations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and triage feature flag and experiment issues such as false or empty evaluations, flicker/flash-of-original-content, stale person or group properties, exposure attribution problems, and server-side or bootstrap latency that lead to incorrect behavior.

Core Features & Use Cases

  • Structured diagnostic framework: Step-by-step questions to inspect flag definitions, rollout conditions, variants, and recent configuration changes.
  • Evidence correlation: Guide to query and interpret recent $feature_flag_called events, evaluate identify/identify-timing effects, and detect property ingestion race conditions.
  • Experiment and latency analysis: Checks for exposure deduplication, server-side evaluation latency, bootstrap timing, and searching docs and GitHub for known bugs to produce remediation guidance.

Quick Start

Run the feature flag diagnosis for the flag key my_flag and user distinct_id 123 to produce a confidence-graded root cause report with evidence and actionable fixes.

Frequently Asked Questions about posthog-feature-flag-diagnosis

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

FAQPage Schema
How do I diagnose a PostHog feature flag evaluating to false or empty incorrectly?

Diagnose false or empty feature flag evaluations by analyzing flag definitions, rollout conditions, and recent configuration changes. The tool correlates evaluation evidence and recent $feature_flag_called events to identify property ingestion races and produce a confidence-graded root cause assessment.

Why does my PostHog feature flag flicker or flash original content before loading?

Feature flag flicker or flash-of-original-content often stems from server-side evaluation latency or bootstrap timing issues. The diagnostic tool inspects bootstrap configurations, evaluates identify timing effects, and checks exposure deduplication to generate actionable remediation steps.

How do I troubleshoot stale person or group properties affecting PostHog experiment evaluations?

Troubleshoot stale person or group properties by querying recent $feature_flag_called events and evaluating identify timing guidance. The tool detects property ingestion race conditions and correlates them with flag definitions to explain evaluation failures.

What's the best way to find known bugs causing PostHog feature flag misconfigurations?

Find known bugs causing feature flag misconfigurations by searching PostHog documentation and GitHub issues for related errors. The tool correlates these findings with your specific flag key and distinct_id evaluation evidence to deliver targeted remediation guidance.

Can I use this feature flag diagnosis tool for both frontend and server-side PostHog SDK scenarios?

Yes, the tool applies to both PostHog frontend and server-side SDK scenarios to analyze evaluation evidence. It identifies timing issues, bootstrap problems, and exposure deduplication across both environments to produce a confidence-graded root cause report.

PostHog feature flag not working correctly, what are the common limitations and edge cases to check?

Common limitations and edge cases for failing feature flags include property ingestion races, identify timing delays, and exposure deduplication conflicts. The tool inspects these constraints alongside recent configuration changes to isolate the root cause.