# MotherDuck agent skills for Claude Code, Cursor and RevampKey

> Ready-made MotherDuck playbooks for AI agents: audit your MotherDuck data quality with AI, build and share MotherDuck Dives with AI, explore a MotherDuck schema and answer data questions. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use MotherDuck safely with AI](https://revampkey.com/marketplace/motherduck/skills/essentials.md): Works out which database and access level you mean before any query, picks the lightest tool for the job, and asks for your explicit yes before anything changes data or shares it.
- [Audit your MotherDuck data quality with AI](https://revampkey.com/marketplace/motherduck/skills/data-quality-audit.md): Runs a read-only audit of a database or table for nulls, duplicates, unexpected values, freshness gaps and suspicious row counts. It returns a prioritised findings report with counts and evidence, and changes no data.
- [Build and share MotherDuck Dives with AI](https://revampkey.com/marketplace/motherduck/skills/dive-authoring-and-sharing.md): Turns one business question into a clear, verified MotherDuck Dive, reviews and updates existing Dives without breaking them, and asks before sharing any data.
- [Explore a MotherDuck schema and answer data questions](https://revampkey.com/marketplace/motherduck/skills/explore-schema-and-answer-data-questions.md): Maps an unfamiliar MotherDuck database through its tables and columns, then writes read-only SQL to answer a business question. It checks grain, joins and sample sizes before reporting a number, and asks before changing anything.

## Install

- RevampKey: connect MotherDuck at https://revampkey.com/marketplace/motherduck; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
for s in essentials data-quality-audit dive-authoring-and-sharing explore-schema-and-answer-data-questions; do
  curl -fsSL --create-dirs -o .agents/skills/motherduck-$s/SKILL.md https://revampkey.com/marketplace/motherduck/skills/$s/SKILL.md
done
```

### What is a MotherDuck agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each MotherDuck skill describes one job, which MotherDuck tools to use in which order, what to check first and when to stop and ask you.

### Do the MotherDuck skills change anything on their own?

2 of the 4 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in MotherDuck.

### Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect MotherDuck; elsewhere you copy the folders into your project or skills directory.

### Do I need the MotherDuck MCP server too?

Yes. The skills tell the agent how to do the work; the MotherDuck MCP server gives it the tools to do it. The MotherDuck MCP setup guide covers every client.

MCP setup guide: https://revampkey.com/marketplace/motherduck.md