# Duckdb differential

> Duckdb differential is an open-source agent skill for databases. Versioned DuckDB databases with the differential community extension (DuckDB 2.0) - snapshots, branches, clones, restore, branch merging, AT. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/tobilg/duckdb-differential/tree/main/plugins/duckdb-differential/skills/duckdb-differential
- **Repository:** https://github.com/tobilg/duckdb-differential
- **GitHub stars:** 50
- **License:** MIT
- **Skill name:** duckdb-differential
- **Collection:** https://github.com/tobilg/duckdb-differential
- **Categories:** databases
- **Listing updated:** 2026-11-17

## About

Versioned DuckDB databases with the differential community extension (DuckDB 2.0) - snapshots, branches, clones, restore, branch merging, AT time travel, and replication through S3 (exports, branch heads, followers, WAL shipping, failover, shared multi-writer databases). Use when the user mentions duckdb-differential, ATTACH 'differential:...' paths or differential_* functions, or wants to version, branch, roll back, time-travel, replicate, sync or fail over DuckDB databases, including leader/follower setups on S3.

## When your agent uses it

> Versioned DuckDB databases with the differential community extension (DuckDB 2.0) - snapshots, branches, clones, restore, branch merging, AT time travel, and replication through S3 (exports, branch heads, followers, WAL shipping, failover, shared multi-writer databases). Use when the user mentions duckdb-differential, ATTACH 'differential:...' paths or differential_* functions, or wants to version, branch, roll back, time-travel, replicate, sync or fail over DuckDB databases, including leader/follower setups on S3.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Instructions only, no scripts](https://github.com/tobilg/duckdb-differential/tree/HEAD/plugins/duckdb-differential/skills/duckdb-differential)
- [License: MIT](https://github.com/tobilg/duckdb-differential/tree/HEAD/plugins/duckdb-differential/skills/duckdb-differential)

## Install

### Claude Code

This skill ships in the `duckdb-differential` plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

```sh
/plugin marketplace add tobilg/duckdb-differential
/plugin install duckdb-differential@duckdb-differential
```

Or copy only this skill to `~/.claude/skills/duckdb-differential`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/tobilg/duckdb-differential.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/duckdb-differential &&
cp -R "$tmp/plugins/duckdb-differential/skills/duckdb-differential" ~/.claude/skills/duckdb-differential &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/duckdb-differential` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/duckdb-differential` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/tobilg/duckdb-differential.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/duckdb-differential &&
cp -R "$tmp/plugins/duckdb-differential/skills/duckdb-differential" ~/.agents/skills/duckdb-differential &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/duckdb-differential` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/duckdb-differential` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/tobilg/duckdb-differential.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/duckdb-differential &&
cp -R "$tmp/plugins/duckdb-differential/skills/duckdb-differential" ~/.cursor/skills/duckdb-differential &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/duckdb-differential` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/tobilg/duckdb-differential.git --path plugins/duckdb-differential/skills/duckdb-differential
```

Or copy the folder to `~/.gemini/skills/duckdb-differential` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/duckdb-differential`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/tobilg/duckdb-differential.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/duckdb-differential &&
cp -R "$tmp/plugins/duckdb-differential/skills/duckdb-differential" ~/.copilot/skills/duckdb-differential &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/duckdb-differential` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/tobilg/duckdb-differential.git
```

Then copy `duckdb-differential/plugins/duckdb-differential/skills/duckdb-differential` into your agent's skills folder as `duckdb-differential`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install Duckdb differential in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/duckdb-differential to use it in all your projects, or to .claude/skills/duckdb-differential in one project. Or install the duckdb-differential plugin, which includes it: /plugin marketplace add tobilg/duckdb-differential, then /plugin install duckdb-differential@duckdb-differential.

### Does Duckdb differential run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Duckdb differential?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to Duckdb differential?

The closest alternatives to Duckdb differential are Bigquery pipeline audit, SQL server table reconciliation, Postgresql optimization, Pinecone rag and Postgresql code review.

## Alternatives

- [Bigquery pipeline audit](https://ai-powered.com/skills/bigquery-pipeline-audit): Bigquery pipeline audit is an open-source agent skill for databases.
- [SQL server table reconciliation](https://ai-powered.com/skills/sql-server-table-reconciliation): SQL server table reconciliation is an open-source agent skill for databases.
- [Postgresql optimization](https://ai-powered.com/skills/postgresql-optimization): Postgresql optimization is an open-source agent skill for databases.
- [Pinecone rag](https://ai-powered.com/skills/pinecone-rag): Pinecone rag is an open-source agent skill for knowledge and memory.
- [Postgresql code review](https://ai-powered.com/skills/postgresql-code-review): Postgresql code review is an open-source agent skill for databases.
- [Snowflake semanticview](https://ai-powered.com/skills/snowflake-semanticview): Snowflake semanticview is an open-source agent skill for databases.
- [Creating oracle to postgres migration integration tests](https://ai-powered.com/skills/creating-oracle-to-postgres-migration-integration-tests): Creating oracle to postgres migration integration tests is an open-source agent skill for databases.
- [Migrating oracle to postgres data access code](https://ai-powered.com/skills/migrating-oracle-to-postgres-data-access-code): Migrating oracle to postgres data access code is an open-source agent skill for databases.

---
Source: https://ai-powered.com/skills/duckdb-differential
