motherduck-build-dashboard

Compose multi-section MotherDuck analytics dashboards as saved Dives from live data.

53|3|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/motherduckdb/agent-skills --skill motherduck-build-dashboard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: motherduck-build-dashboard
Source: https://github.com/motherduckdb/agent-skills/tree/main/plugins/motherduck-skills-claude/skills/motherduck-build-dashboard
Command: npx skills add https://github.com/motherduckdb/agent-skills --skill motherduck-build-dashboard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This skill helps you turn messy discovery into a coherent, multi-section analytics dashboard backed by live MotherDuck queries and saved as a shareable Dive artifact.

Core Features & Use Cases

  • Compose a single narrative dashboard: generate KPIs plus a primary trend and optional breakdown/detail sections as one analytic story.
  • Discover real schema before building: starts by confirming a MotherDuck server is active and shaping the dashboard based on available tables, grain, and key columns.
  • Build reliable Dive visuals: orchestrates motherduck-explore, motherduck-query, and motherduck-create-dive, using motherduck-duckdb-sql when exact DuckDB syntax matters.
  • Produce a saved, shareable workspace artifact: keeps the result as a Dive (workspace analytics surface) rather than a full customer-facing application.

Quick Start

Ask for a Dive dashboard that summarizes a single KPI story from your existing MotherDuck data, including KPIs, a time trend, and a breakdown view.

Frequently Asked Questions about motherduck-build-dashboard

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

FAQPage Schema
How do I build a shareable analytics dashboard from live MotherDuck data?

You can build a shareable analytics dashboard from live MotherDuck data by composing KPIs, trends, breakdowns, and detail tables into a single coherent narrative saved as a Dive artifact. The dashboard queries existing datasets directly to surface real-time metrics.

What is a Dive dashboard in MotherDuck and when do I need one?

A Dive dashboard is a saved, shareable workspace analytics surface that presents a multi-section analytic story backed by live MotherDuck queries. You need one when a workspace analytics request requires reusable artifacts rather than a full customer-facing application.

Can I create KPIs and time trends from existing DuckDB SQL datasets?

Yes, you can create KPIs and time trends from existing DuckDB SQL datasets by confirming the active MotherDuck server schema first. The dashboard shapes visuals based on available tables, grain, and key columns to ensure accurate reporting.

What's the best way to structure a multi-section analytics dashboard with DuckDB?

The best way to structure a multi-section analytics dashboard with DuckDB is to orchestrate schema exploration, live querying, and Dive creation sequentially. This approach ensures the dashboard respects DuckDB SQL syntax guidance while producing a single narrative artifact.

Do I need an active MotherDuck server to build a KPI dashboard?

Yes, you need an active MotherDuck server to build a KPI dashboard because the process starts by confirming the server is active and discovering the real schema. Live queries depend on accessing existing tables, grain, and key columns directly from the workspace.

Why does my MotherDuck dashboard query fail during visual creation?

MotherDuck dashboard queries can fail during visual creation if the DuckDB SQL syntax is incorrect or the schema is not properly discovered. The process addresses this by using syntax verification and confirming available tables and key columns before shaping the dashboard visuals.