Motherduck explore
Discover and explore databases, tables, columns, and data shares in MotherDuck. Use when you need to understand what data is available, preview table contents, or search the data catalog.From its SKILL.md
npx -y skills add motherduckdb/agent-skills --skill motherduck-exploreAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.0 KB, 377 tokens by cl100k_base, as published. Nobody here has run it
Explore MotherDuck Data
Use this skill when you need to discover what databases, tables, and columns exist in a MotherDuck account; preview and sample data; understand schemas and data types; find shared databases; or search the data catalog.
Prerequisites
- An established MotherDuck connection (or an active MotherDuck MCP server)
Default Posture
- Explore top-down: databases, then tables/views, then columns, then statistics, then sample rows.
- Use fully qualified table names once more than one database is attached.
- Check shared databases before concluding that data is unavailable.
- Use the MotherDuck MCP tools (
list_databases,list_tables,list_columns,search_catalog) when available because they return structured results faster than ad hoc SQL. - Return a concise schema map with table grain, join keys, date columns, and likely measures before moving into modeling or dashboard work.
Workflow
- List databases in scope.
- List tables and views in the target database.
- Inspect columns, types, nullability, and comments before writing queries.
- Run
SUMMARIZEon important tables to understand ranges, cardinality, and null rates. - Preview rows, capture grain and join assumptions, and only then move into analytical SQL or modeling work.
Open Next
- Read
references/EXPLORATION_PLAYBOOK.mdfor the full SQL workflow, share discovery patterns, MCP tool guidance, and common exploration mistakes
Related Skills
motherduck-connectfor session setup and authenticationmotherduck-queryfor analytical SQL after the schema is understoodmotherduck-duckdb-sqlfor DuckDB syntax patterns during explorationmotherduck-share-datafor creating and consuming shares once shared datasets become part of the workflow
What ships with it: 1 file
5.8 KB alongside SKILL.md
references/
- EXPLORATION_PLAYBOOK.md5.8 KB