skills.rest
PostHog
PostHogOFFICIAL
Explore all skills by this author →
Website𝕏@PostHogGitHub

building-a-dashboard

Creates and updates PostHog dashboards by assembling insight tiles via MCP tools.

713|118|Updated Aug 11, 2020
Search Tags:#metrics#mcp#insights#Templates#PostHog#product analytics#Dashboard
One-click install
npx skills add https://github.com/PostHog/posthog-foss --skill building-a-dashboard
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: building-a-dashboard
Source: https://github.com/PostHog/posthog-foss/tree/main/products/dashboards/skills/building-a-dashboard
Command: npx skills add https://github.com/PostHog/posthog-foss --skill building-a-dashboard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Assembling a useful PostHog dashboard requires deciding whether to create or update, finding reusable insights, creating missing ones, and laying out tiles correctly — this Skill guides that entire workflow over MCP instead of manual clicking.

Core Features & Use Cases

  • Create vs Update Decisions: Searches existing dashboards with fuzzy matching and reads current tiles before making changes, asking clarifying questions when intent is ambiguous.
  • Template-Guided Design: Consults PostHog's vetted dashboard templates as reference for which insights pair well on topics like retention, revenue, or activation.
  • Insight Reuse and Assembly: Reuses existing insights where possible, creates missing ones, and manages tile layout while preserving existing placement unless reordering is requested.
  • Use Case: A user asks to "put my key product metrics on one page" — the Skill searches for existing dashboards and insights, builds a focused dashboard with the right tiles, and verifies the tiles return data.

Quick Start

Ask the assistant to create a PostHog dashboard for product analytics combining your retention, activation, and revenue insights.

Frequently Asked Questions about building-a-dashboard

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

FAQPage Schema
How do I create a dashboard in PostHog with multiple insights?▼

Search existing insights with insights-list, create any missing ones with insight-create, then call dashboard-create with a short name and description and add the insight tiles. Verify the result with dashboard-insights-run to confirm tiles return data.

How do I add or remove insights on an existing PostHog dashboard?▼

Use dashboard-update with the full intended set of tiles, since any insights you omit are removed. First read the dashboard with dashboard-get to see its current tiles, then include the ones you want to keep alongside your changes.

Should I reuse existing insights or create new ones for a dashboard?▼

Prefer reusing existing insights by searching with insights-list and reading candidates with insight-get to confirm they match intent and have data. Create new insights only for gaps, and keep the tile set minimal and focused.

What are PostHog dashboard templates and how do I use them?▼

PostHog ships vetted dashboard templates for common topics, browsable with dashboard-templates-list and inspectable with dashboard-templates-retrieve. Treat them as examples of which insights pair well, but tailor every insight to your own events and properties.

When should I not use a dashboard in PostHog?▼

Skip a dashboard when saving a single insight, since it stands alone. For non-insight tiles like text cards or widgets, use the widget tools such as dashboard-widget-catalog-list and dashboard-widgets-batch-add instead.

Related Skills

Explore More Data & Analytics Skills→
COCOSiL-incCOCOSiL-inc
1

integration-nextjs-app-router

Integrate PostHog event capture and error tracking into Next.js App Router applications.

Official
Intermediate
PostHogPostHog
58

managing-subscriptions

Manage PostHog subscriptions for scheduled insight and dashboard snapshots.

Official
Intermediate
safzanpiranisafzanpirani
1

writing-beats

Guide raw text into narrative beats for articles, reports, or scripts.

Community
Intermediate
PostHogPostHog
75

querying-posthog-data

Query PostHog analytics data using HogQL and SQL foundations.

Official
Intermediate