Agent Skills

MotherDuck Skills

22 skills for coding agents working with MotherDuck: connect applications, query real data with DuckDB SQL, build Dives and Flights, and deliver analytics pipelines and apps.

Each skill includes focused instructions and, where useful, detailed references and runnable examples. Installing the skills does not configure a MotherDuck connection or MCP server.

Install

Choose one route for your agent. Run commands beginning with / inside the agent; run the others in your terminal.

Agent	Install
Claude Code / GitHub Copilot CLI	/plugin marketplace add motherduckdb/agent-skills, then /plugin install motherduck-skills@motherduck-skills
Codex	codex plugin marketplace add motherduckdb/agent-skills, then open /plugins and install MotherDuck Skills
Gemini CLI	gemini extensions install https://github.com/motherduckdb/agent-skills
Cursor / VS Code / other supported agents	Use the Skills CLI below

The Skills CLI needs Git and Node.js 22.20+ (package requirements). No global CLI installation is needed:

npx -y skills add motherduckdb/agent-skills

Select the skills and agents interactively. To install the whole catalog for Cursor:

npx -y skills add motherduckdb/agent-skills --agent cursor --skill '*' --yes --global

Use --agent github-copilot for VS Code/GitHub Copilot, or another supported agent name. Omit --global for a project-scoped install.

See the install matrix for alternatives, updates, verification, and manual installation. Harness support documents the discovery paths and plugin manifests.

Use the Skills

Ask for the task directly, or name a skill from the catalog:

Use motherduck-connect to choose the connection path for this app.

Explore my MotherDuck workspace and build a sales dashboard as a Dive.

Plan a migration to MotherDuck with validation and rollback steps.

For live work, configure MotherDuck MCP or an authenticated database client. Supply credentials through your normal secret or environment setup, never in prompts or committed files.

Start with the skill that matches the task. Reuse established connection and schema context; load supporting references only when needed. The skills favor DuckDB SQL, live schema discovery, native MotherDuck storage by default, and backend credentials for customer-facing apps.

Skills Overview

Utility skills handle individual operations; workflow skills cover specific MotherDuck capabilities; use-case skills combine them for end-to-end work.