posthog

Query PostHog analytics with HogQL and manage dashboards, funnels, and feature flags.

6|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/thensls/nsls-builder-toolkit --skill posthog-thensls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: posthog
Source: https://github.com/thensls/nsls-builder-toolkit/tree/main/skills/posthog
Command: npx skills add https://github.com/thensls/nsls-builder-toolkit --skill posthog-thensls

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provide conversational access to PostHog analytics so non-technical and technical users can run queries, investigate users and errors, and manage dashboards and feature flags without manually navigating the PostHog UI or writing HogQL from scratch.

Core Features & Use Cases

  • HogQL query execution and generation: turn natural language questions into HogQL, run queries, and refine results for event counts, property analysis, and user timelines.
  • Dashboard and insight management: create, update, and add insights to dashboards; follow a create → test → iterate pattern and respect the permanent-delete semantics.
  • Person lookup & investigation: search persons by email or distinct_id, inspect their event timeline and properties, and cross-reference with other systems for attribution.
  • Funnels, errors, and feature flags: build ordered or unordered funnels (with regex workarounds for OR filters), list and drill into errors while filtering by $host, and create/manage feature flags and experiments under an enforced permission model.
  • Use Case: Investigate a sudden drop in conversion by confirming project, filtering by $host, running a funnel query, checking identity chain issues, and recommending engineering or product actions.

Quick Start

Query the last 7 days of step_start events for members.nsls.org, return counts, and propose a funnel from signup to onboard.

Frequently Asked Questions about posthog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert natural language questions into HogQL for PostHog analytics?

You can generate and execute HogQL queries from natural language to retrieve PostHog event counts, property analyses, and user timelines without manually writing the query syntax.

How do I look up a specific user's event history in PostHog?

You can search for persons by email or distinct_id to inspect their PostHog event timeline and properties, allowing you to cross-reference user histories for attribution.

Can I manage PostHog feature flags and experiments using a permission model?

Yes, you can create and manage feature flags and experiments under an enforced three-tier permission model designed to safely handle configuration and destructive actions.

What is the best way to debug a sudden conversion drop in a PostHog funnel?

You can debug funnel conversions by filtering events by $host, running ordered or unordered funnel queries, checking identity chain issues, and recommending engineering actions.

Does this tool support creating and updating PostHog dashboards and insights?

Yes, you can create, update, and add insights to PostHog dashboards following a create, test, and iterate pattern while respecting permanent-delete semantics.

How do I list and filter PostHog errors by host?

You can list and drill into PostHog errors by filtering them through the $host property to isolate diagnostic information for specific domains.