# building-a-dashboard

building-a-dashboard — a skill for Claude Code, Codex, and Cursor that builds and updates PostHog dashboards via MCP tools. Coordinates insight reuse and grid layout.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 208 installs · ★ 101 repo stars
- Author: PostHog
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/building-a-dashboard/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/building-a-dashboard

## What it does

Runs across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It guides an agent through PostHog dashboard operations by running `dashboards-get-all` before making changes, inspecting candidate templates with `dashboard-templates-retrieve`, and checking for existing graphs via `insights-list`.

Canonical metric definitions rely entirely on PostHog's Data Catalog via `posthog:metric-list` and `posthog:metric-describe`. The agent is instructed never to treat `agent_context` notes as official metric governance when a catalog entry is missing.

Layout updates pass through `dashboard-update` on a standard 12-column grid. Insights favor native typed runners like funnels, retention, and paths, keeping raw SQL insights reserved for specific custom joins.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/building-a-dashboard/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/building-a-dashboard/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/building-a-dashboard/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/building-a-dashboard/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/building-a-dashboard
```

2. **Manually: put the files in place**
- File: `.github/skills/building-a-dashboard/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/building-a-dashboard
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/building-a-dashboard/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/building-a-dashboard/SKILL.md

## When to use it
- build a fresh analytics dashboard in PostHog over MCP
- update existing dashboard tiles without clearing the whole layout
- verify canonical metrics against the PostHog Data Catalog
- position insight tiles across the PostHog 12-column grid

## Example prompts
- Assemble a retention and activation dashboard in PostHog
- Add a 7-day stickiness chart to my existing product dashboard
- Replace the old signups tile on the team overview dashboard

## Similar
- [measure-dashboard-requirements](https://affpapa.org/en/nevibecode/skills/measure-dashboard-requirements.md) — skill · 847 installs
- [signals-scout-anomaly-detection](https://affpapa.org/en/nevibecode/skills/signals-scout-anomaly-detection.md) — skill · 318 installs
- [firecrawl-dashboard-reporting](https://affpapa.org/en/nevibecode/skills/firecrawl-dashboard-reporting.md) — skill · 32000 installs
- [corezoid-dashboard-manager](https://affpapa.org/en/nevibecode/skills/corezoid-dashboard-manager.md) — skill · ★ 74 repo stars
- [signals-scout-observability-gaps](https://affpapa.org/en/nevibecode/skills/signals-scout-observability-gaps.md) — skill · 316 installs
- [affiliate-performance-dashboard](https://affpapa.org/en/nevibecode/skills/affiliate-performance-dashboard.md) — skill · 17600 installs

From the same set: [posthog/ai-plugin](https://affpapa.org/en/nevibecode/by/posthog/ai-plugin.md) — 82 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
