dashboard-expert

Create, analyze, modify, and annotate Mixpanel dashboards via the mixpanel_headless Python API.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill dashboard-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dashboard-expert
Source: https://github.com/openai/plugins/tree/main/plugins/mixpanel-headless/skills/dashboard-expert
Command: npx skills add https://github.com/openai/plugins --skill dashboard-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mixpanel_headless, and includes references (resource) components.

What problem does it solve?

Building and maintaining Mixpanel dashboards programmatically involves a tricky layout grid, content action ordering rules, and text card formatting quirks that cause silent failures. This Skill encodes the full CRUD workflow so dashboards are created, read, updated, and annotated correctly on the first attempt.

Core Features & Use Cases

  • Four operating modes: Analyze existing dashboards (read structure, execute reports, summarize), Build new dashboards (investigate data, plan layout, create), Modify existing ones (ordered content and layout patches), and Explain (auto-generate data-driven text card insights).
  • Layout and content management: Handles the 12-column grid, width redistribution, temp ID resolution, and the required operation ordering (metadata, creates, reorder, updates, deletes).
  • Rich references: Ships with a complete API reference, 9 dashboard design templates (KPI, AARRR, funnel, retention, and more), a chart type selection guide, and a bookmark pipeline covering all four Mixpanel query engines.
  • Use Case: Ask to build a product health dashboard, and the Skill discovers top events, validates data volume, queries insights/funnels/retention, lays out rows with section headers, and pins the finished dashboard for the team.

Quick Start

Ask the assistant to analyze an existing Mixpanel dashboard by ID or build a new product health dashboard from your project's top events.

Frequently Asked Questions about dashboard-expert

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

FAQPage Schema
How do I create a Mixpanel dashboard programmatically in Python?

Use mixpanel_headless to call ws.create_dashboard with CreateDashboardParams, passing a title, description, and optional rows containing text cards and reports. Query each metric first with typed methods like ws.query or ws.query_funnel, then embed results via DashboardRowContent.

How do I add a report to an existing Mixpanel dashboard row?

Send both content and layout fields together in a single UpdateDashboardParams call. Add a temp_id cell to the target row, redistribute widths so all cells sum to 12, and include the full rows_order and rows list in the layout patch.

Why does my Mixpanel text card render garbled HTML?

Mixpanel's TipTap editor mangles HTML containing newlines. Strip all newline characters with .replace("\n", "") before sending, and use only allowed tags like h2, p, strong, and ul since div, span, b, and img are stripped.

Why is my new Mixpanel dashboard invisible to my team?

Dashboards are private and unpinned by default after creation. Call ws.pin_dashboard(dashboard.id) to make the dashboard visible at the top of the dashboard list for all project members.

What chart types can I use for Mixpanel insights reports?

Valid chartType values include line, bar, column, pie, table, and insights-metric. Stacked variants are set via plotStyle: "stacked" on the base chart type, not through separate chartType slugs like bar-stacked, which the API rejects.

What are the limits for Mixpanel dashboard layouts?

Each dashboard supports a maximum of 30 rows with up to 4 items per row, and cell widths in a row must sum to exactly 12. Titles are limited to 255 characters, descriptions to 400, and text cards to about 2,000 characters.