Building a dashboard

A dashboard is a collection of insight tiles on one page. Your job is to figure out which insights belong on it, reuse what already exists, create what's missing, and lay them out sensibly — not to blindly generate charts.

When the dashboard needs explanatory text, keep user copy and agent context separate. Use the writing-user-facing-copy skill for text that people read. Use agent_context for information that an agent needs to maintain the dashboard.

PostHog's Data Catalog is the semantic layer. Store canonical metric definitions there. Never use agent_context as a substitute for a Data Catalog metric.

Create vs update

First work out whether you're creating a new dashboard or changing an existing one.