building-a-dashboard — Claude Code skill: what it does, how to install
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.
no license 208 installs ★ 101 updated 2026-11-10
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a claude-codeWhat building-a-dashboard 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.
What it helps with
- 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 for the agent
- 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
How to install building-a-dashboard
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a claude-code2Manually: put the files in place
~/.claude/skills/building-a-dashboard/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/building-a-dashboard/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a codex2Manually: put the files in place
.agents/skills/building-a-dashboard/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a cursor2Manually: put the files in place
.cursor/skills/building-a-dashboard/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/building-a-dashboard2Manually: put the files in place
.github/skills/building-a-dashboard/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/building-a-dashboardManually: put the files in place
.devin/skills/building-a-dashboard/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill building-a-dashboard -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about building-a-dashboard
How to install building-a-dashboard in Claude Code?
Run npx skills add PostHog/ai-plugin --skill building-a-dashboard -a claude-code in your terminal.
What does building-a-dashboard do?
It orchestrates PostHog dashboard setup through MCP tools, preventing duplicate insights and enforcing proper layout structure.
Can it invent metric definitions inside dashboard notes?
No, it requires approved definitions from PostHog Data Catalog and forbids using agent_context as a substitute for official metric definitions.