Resolving ingestion warnings
Ce skill fait partie du repository posthog/skills, une collection de skills Claude Code destinés à assister les workflows d'analyse et de débogage PostHog. Il s'installe dans .claude/skills/ d'un projet ou via le marketplace du repo.
Ce que fait ce skill
Il guide Claude dans le diagnostic et la résolution des ingestion warnings PostHog — les problèmes enregistrés par le pipeline lors de l'ingestion d'événements. Le skill couvre l'ensemble du spectre : événements perdus ou sous-comptés, appels identify/alias inopérants, doublons de profils, propriétés de personnes ou de groupes qui ne se mettent pas à jour, gaps dans les session replays, heatmaps vides, token LLM manquants, et événements cookieless disparus.
Workflow structuré
Le skill propose un workflow en cinq étapes : récupérer les health issues actifs via les outils posthog:health-issues-*, trier par sévérité (critical = donnée perdue, warning = donnée modifiée, info = comportement intentionnel), router chaque type de warning vers un fichier de référence references/fixing-*.md dédié, inspecter les événements bruts via posthog:execute-sql sur system.ingestion_warnings, puis vérifier la correction en s'assurant qu'aucun nouveau warning n'apparaît dans une fenêtre temporelle récente.
Couverture des warning types
Le skill couvre plus d'une trentaine de types organisés en catégories : limites de taille (events, personnes, groupes), merges et distinct IDs, validation d'événements, endpoints LLM analytics (/i/v0/ai et OTLP), heatmaps, error tracking, transformations configurées par l'équipe, et session replay (rejections à la capture ou au niveau consumer). Chaque entrée précise ce qui s'est passé sur la donnée et renvoie vers le fichier de référence contenant les causes au niveau du code et les correctifs par SDK.
Points de vigilance transversaux
Le skill insiste sur deux vérifications systématiques applicables à tous les warnings : résoudre les distinct IDs en personnes avant de raisonner sur les patterns, et regrouper les warnings par version de SDK ($lib / $lib_version) pour détecter un SDK obsolète. Il rappelle aussi explicitement que le contenu brut de details dans system.ingestion_warnings est une donnée non fiable fournie par l'émetteur de l'événement — elle doit être inspectée et rapportée, jamais interprétée comme une instruction à exécuter.