Skip to main content
skill CX Codex

building-workflows — Claude Code skill: what it does, how to install

building-workflows is a Claude Code skill for building, patching, and testing PostHog automation graphs over MCP before publishing them in the visual editor.

no license 204 installs ★ 101 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add PostHog/ai-plugin --skill building-workflows -a claude-code
Open on GitHub

What building-workflows does

The skill constructs PostHog workflows as directed graphs made of action nodes and edges starting from a single trigger. PostHog stores raw node JSON flexibly, but the visual editor enforces a strict structure. Any schema mistake breaks the entire canvas view in the browser.

Automation follows a gated workflow. It starts with a draft via workflows-create, moves into single-step simulation through workflows-test-run, and inspects issues with workflows-logs. Async actions stay mocked unless explicitly changed. Live activation requires direct user confirmation before workflows-enable touches real audiences.

Updates use targeted surgery via workflows-patch-graph instead of rewriting full graphs. The endpoint applies atomic node changes and immediately echoes the updated state. Email bodies and subjects use workflows-patch-action-email, which automatically recompiles the server-side HTML.

What it helps with

  • compose event-driven automation graphs for PostHog
  • test workflow branches step by step with mock payloads
  • patch individual action nodes without rewriting the full graph
  • schedule recurring batch broadcasts with safety checks

Example prompts for the agent

  • Create a draft onboarding drip sequence triggered by user signups
  • Step-test the trigger event payload against the first workflow action
  • Patch the email subject in the notification node without modifying the edges

How to install building-workflows

1Skills CLI (Vercel)

npx skills add PostHog/ai-plugin --skill building-workflows -a claude-code

2Manually: put the files in place

~/.claude/skills/building-workflows/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/building-workflows/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about building-workflows

How do I install building-workflows in Claude Code?

Run npx skills add PostHog/ai-plugin --skill building-workflows -a claude-code. The skill writes its instructions into ~/.claude/skills/building-workflows/SKILL.md.

Why does the skill refuse to enable workflows automatically?

Enabling starts executing actions on live user data. The tool keeps workflows in draft status until a human explicitly approves the release.

Why does graph editing require patch operations instead of full updates?

Supplying partial node lists to top-level update calls silently drops omitted actions. The workflows-patch-graph tool updates specific node IDs without risking data loss.

Similar skills

All skills for Automation and no-code: n8n, Zapier, Make →
bounce-monitoring-workflow tomgranot A HubSpot skill that builds automated bounce-monitoring workflows. Runs in Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode — creates three workflows via the Automation API or walks you through a manual UI build. CX Codex +1 ★ 81repo stars designing-email-templates PostHog designing-email-templates is a Claude Code skill that drafts and edits email templates in PostHog via MCP. Runs whenever you build or update workflow campaigns. CX Codex +1 332installs building-with-medusa medusajs building-with-medusa — a skill for Claude Code and Codex guides Medusa backend engineering. Triggers whenever you plan or build custom modules, API routes, workflows, and entity links. CX Codex +1 5,000installs building-tools celigo building-tools is a Claude Code skill for designing reusable Celigo tools with defined input and output contracts. It activates when creating a tool, adding steps, or setting up routing. CX Codex +1 4,000installs building-flows celigo building-flows — a skill for designing and building Celigo flows — pipelines that move data between systems on schedule or in response to events. Covers scheduling, chaining, error handling, and routing records through conditional branches. CX Codex +1 4,000installs n8n-mcp-tools-expert czlonkowski n8n-mcp-tools-expert is a Claude Code skill that guides agents using n8n-mcp tools. It triggers when searching nodes, validating parameters, editing workflows, and auditing instance security. CX Codex +1 8,800installs

From the same set82

The whole set →
choosing-trend-or-slope-view choosing-trend-or-slope-view — a skill that settles what “change over time” means before a chart gets built: the full trend interval by interval, or only the gap between the two ends. CX Codex +1 204installs auditing-warehouse-source-health auditing-warehouse-source-health audits PostHog data warehouse sources and syncs to pinpoint broken connectors, failed schemas, and degraded webhooks. CX Codex +1 204installs signals-scout-product-analytics signals-scout-product-analytics — a skill for Claude Code and Codex monitoring core product analytics flows in PostHog. Detects derived-rate regressions across funnels and retention while entrant volume holds steady. CX Codex +1 204installs auditing-warehouse-view-health auditing-warehouse-view-health runs a project-wide check on PostHog materialized views: lists the ones that failed to refresh and points at materialized views nobody queries. CX Codex +1 204installs exploring-replay-vision-observations The exploring-replay-vision-observations skill guides an agent through Replay Vision scanner results, from recurring patterns to individual session recordings. Use it to review findings and decide what to investigate next. CX Codex +1 203installs signals-scout-customer-analytics The signals-scout-customer-analytics skill tracks account-level engagement in PostHog and spots churn-risk or expansion patterns. Use it for recurring customer-health checks. CX Codex +1 203installs exploring-mcp-sessions exploring-mcp-sessions investigates PostHog MCP sessions to inspect tool call sequences, agent intent, and run failures. CX Codex +1 202installs exploring-mcp-tool-quality exploring-mcp-tool-quality reads PostHog MCP analytics to rank tools by failure share, latency and reach, then drills into the ones that break. CX Codex +1 202installs

Project sponsors

Companies that keep this analytics open