motherduck-model-data

Generate MotherDuck SQL files and a model_manifest.yml DAG for analytical schemas.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you design and restructure analytical schemas in MotherDuck without ending up with one-off, hard-to-review SQL scattered across chat.

Core Features & Use Cases

  • File-based modeling scaffold: Generates a lightweight project structure (raw, staging, analytics) instead of only producing SQL to run immediately.
  • Explicit model DAG via manifest: Produces a model_manifest.yml capturing dependencies, materialization strategy, and model metadata for reproducible rebuilds.
  • Analytics-first schema decisions: Guides denormalized, read-optimized modeling patterns with explicit types, nullability, and fully qualified names.

Quick Start

Use motherduck-model-data to create a new analytics-ready data model for “orders and customers” with raw, staging, and analytics layers, including a model_manifest.yml that defines the dependencies.

Frequently Asked Questions about motherduck-model-data

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

FAQPage Schema
How do I design an analytics schema in MotherDuck without scattering SQL across chat?

To design an analytics schema in MotherDuck without scattered SQL, use a file-based modeling scaffold that generates a structured project with raw, staging, and analytics layers. This approach produces reviewable SQL files organized by lifecycle stage instead of one-off scripts.

How do I build a dependency DAG for multi-stage DuckDB transformations?

You build a dependency DAG for multi-stage DuckDB transformations by generating a model_manifest.yml file. This manifest captures explicit dependencies, materialization strategies, and model metadata to orchestrate reproducible rebuilds across your analytics tables.

What is the best way to organize ETL orchestration files for MotherDuck analytics workloads?

The best way to organize ETL orchestration files for MotherDuck analytics workloads is a lightweight project structure separating raw, staging, and analytics layers. This scaffold defines relationships, explicit data types, and nullability for read-optimized modeling patterns.

Can I define explicit materialization strategies for DuckDB data models?

You can define explicit materialization strategies for DuckDB data models by declaring them inside a model_manifest.yml. This manifest captures dependency tracking and model metadata, enabling reproducible multi-stage transformation workflows for your analytics tables.

Does MotherDuck support denormalized, read-optimized schema design patterns?

MotherDuck supports denormalized, read-optimized schema design patterns through analytics-first modeling scaffolds. These scaffolds guide schema decisions by enforcing explicit data types, nullability constraints, and fully qualified names across your multi-stage transformation workflows.