HogQL queries for PostHog
Ce skill fournit une aide concrète pour rédiger des requêtes HogQL dans PostHog. HogQL est le dialecte SQL propre à PostHog, construit sur ClickHouse SQL, avec un accès simplifié aux propriétés et des fonctions spécifiques à la plateforme. Il fait partie du repository posthog/skills, une collection de skills destinés à enrichir les workflows assistés par IA via Claude Code.
Ce que contient ce skill
Le SKILL.md embarque directement les principes fondamentaux du langage HogQL : syntaxe d'accès aux propriétés (properties.$nom pour les événements, person.properties.$nom pour les personnes), gestion des filtres UI via le placeholder {filters}, utilisation des variables de dashboard avec {variables.nom}, et fonctions d'agrégation ClickHouse recommandées (uniq(), count(), avg(), sum()).
Il inclut également des patterns SQL prêts à l'emploi pour les cas d'usage les plus courants : requêtes sur les événements, breakdowns par propriété, analyse par propriété de personne, et funnels via windowFunnel() ou sequenceMatch(). Ces exemples servent de point de départ pour construire des insights ou des requêtes API.
Le skill référence aussi un ensemble de fichiers de documentation complémentaires (expressions, agrégations, fonctions ClickHouse, schémas de tables PostHog, sessions…) regroupés dans un dossier references/. Ces fichiers fournissent le contexte détaillé que Claude consulte pour répondre avec précision aux questions HogQL.
Bonnes pratiques intégrées
Plusieurs recommandations de performance sont directement encodées dans le skill : toujours inclure un filtre temporel (timestamp >= now() - INTERVAL 7 DAY), préférer uniq() à count(distinct), éviter les scans multiples de la même table, utiliser dateTrunc() pour les regroupements temporels, et tester les requêtes dans l'éditeur SQL de PostHog avant de les intégrer à des insights ou à l'API. Ces guidelines permettent à Claude de produire des requêtes à la fois correctes et efficaces dans un contexte ClickHouse.