building-workflows

Par posthog · skills

Skill PostHog pour construire, tester et monitorer des workflows automatisés dans PostHog via MCP, en pilotant le graphe d'actions et d'edges JSON.

npx skills add https://github.com/posthog/skills --skill building-workflows

Building workflows — skill PostHog

Ce skill fait partie de la collection officielle posthog/skills, un ensemble de skills Claude destinés à enrichir les workflows assistés par IA autour de la plateforme PostHog. Il s'installe via le marketplace Claude Code ou en copiant le dossier dans .claude/skills/.

Rôle du skill

Ce skill guide Claude pour créer, éditer, tester et monitorer des workflows PostHog (appelés aussi campagnes, drip sequences, automations event-triggered ou broadcasts) entièrement depuis une session Claude, via les outils MCP exposés par PostHog. Il couvre tout le cycle de vie : composition du graphe JSON (actions + edges), création en mode draft, test pas-à-pas, activation contrôlée, dispatch batch/schedule et surveillance des invocations en erreur.

Ce que le skill décrit

Un workflow PostHog est un graphe orienté composé de nœuds d'action (actions) reliés par des edges, avec exactement un nœud trigger. Le skill fournit :

  • La séquence de travail recommandée (composer → créer en draft → tester → activer → monitorer), avec les outils MCP correspondants à chaque étape.
  • Les règles d'édition chirurgicale via workflows-patch-graph (opérations id-addressées, deep-merge) plutôt que remplacement complet du graphe.
  • Le cycle de publication pour les workflows actifs (draft → test → preview d'impact → confirm → publish), avec gestion du rollback par révisions.
  • Les règles strictes sur ce que le serveur gère seul (bytecode, trigger dérivé, champs calculés) et ce qu'il ne faut jamais envoyer manuellement.
  • Les contraintes métier à communiquer à l'utilisateur (ciblage comportemental non supporté, audiences batch sur propriétés personnes uniquement).

Comment l'utiliser

Une fois installé dans votre projet, ce skill est automatiquement chargé par Claude lors de toute demande liée à la création ou modification d'un workflow, d'une campagne, d'une séquence drip ou d'une automation dans PostHog. Il référence des fichiers complémentaires (references/graph-schema.md, references/lifecycle-and-debugging.md) qui font partie du même dossier de skill et définissent le contrat de schéma JSON à respecter. Pour les contenus email embarqués dans un workflow, il s'appuie sur le skill designing-email-templates.

Skills similaires