Skill tools-and-features-hogql
Ce skill fait partie du repository posthog/skills, une collection de skills pour enrichir les workflows assistés par IA dans Claude Code. Il est dédié à la rédaction de requêtes HogQL, le dialecte SQL de PostHog basé sur ClickHouse, qui simplifie l'accès aux propriétés d'événements et de personnes tout en exposant les fonctions analytiques de ClickHouse.
Ce que contient ce skill
Le SKILL.md expose directement les principes clés de HogQL : syntaxe d'accès aux propriétés (properties.$name, person.properties.$name), gestion des filtres dynamiques via {filters}, agrégations recommandées (uniq(), count(), avg()), et patrons de requêtes courants (breakdowns, funnels, propriétés de personnes). Il renvoie également vers plusieurs fichiers de référence situés dans le dossier references/ — expressions, agrégations, fonctions ClickHouse, schémas des tables PostHog, sessions, variables — qui constituent la documentation technique consultable par Claude.
Bonnes pratiques embarquées
Le skill inclut des lignes directrices concrètes : toujours inclure un filtre de plage temporelle, préférer uniq() à count(distinct), utiliser dateTrunc() pour les regroupements temporels, paginer par timestamp plutôt que par OFFSET, et tester les requêtes dans l'éditeur SQL de PostHog avant de les intégrer dans des insights ou via l'API.
Comment l'utiliser
Installez le skill dans votre projet en copiant le répertoire dans .claude/skills/, ou via le marketplace du repo parent avec /plugin install. Une fois actif, Claude peut s'appuyer sur ce skill pour générer, expliquer ou corriger des requêtes HogQL adaptées à vos tableaux de bord et analyses PostHog.