PostHog Analytics Skill

Automate PostHog dashboard creation, sync, update, and export via API.

Prerequisites

Required Tools

• - curl - HTTP client (pre-installed on macOS/Linux)
• INLINECODE1 - JSON processor: brew install jq or INLINECODE3
• INLINECODE4 - Shell (the script is bash)

PostHog API Key

1. 1. Go to PostHog Settings → Personal API Keys
2. Create a new key with read/write access
3. Export it:

CODEBLOCK0

Note: The API key determines your organization and project. The script uses @current project context (your default project).

Verify Setup

CODEBLOCK1

Expected output:
CODEBLOCK2

If you get an error, check your API key is correct and has proper permissions.

Quick Start: Blog Analytics Example

Step 1: Write Your Config

Create blog_dashboard.json:

CODEBLOCK3

Note: Set dashboard_id: null for new dashboards.

Step 2: Create Dashboard

CODEBLOCK4

Output:
CODEBLOCK5

The script:

• - Creates a new dashboard in your PostHog project
• Returns dashboardid (e.g., 1166599) and projectid (e.g., 209268) in the URL
• Automatically updates your config file with the INLINECODE10

Step 3: Add New Insights (Sync)

Edit config to add new insights, then:

CODEBLOCK6

Only creates NEW insights. Existing ones (matched by name) are skipped.

Step 4: Update Existing Insights

Changed your filter? Edit config, then:

CODEBLOCK7

Updates ALL insights with current config settings. Use when changing filters.

Step 5: Export Existing Dashboard

CODEBLOCK8

Config Reference

*At least one filter recommended. filter takes precedence over domain_filter.

Insight Types

Optional Insight Fields

Environment Variables

Files

• - scripts/posthog_sync.sh - CLI script (create/sync/update/export)
• INLINECODE45 - Example config

References

• - PostHog API Docs
• Personal API Keys