v2.6.0

Highlights

• Work with MotherDuck CLI files and reusable business context through dedicated CLI and Guides skills. #50
• Load shorter, more focused instructions: discovery descriptions are 64% shorter, and examples and structured-output contracts are loaded only when needed. #51

Features

• Add motherduck-cli and motherduck-manage-guides, bringing the catalog to 22 skills. #50
• Expand guidance for role-granted Shares, table-level filtering, Dive lifecycle and embedding, and Flight configuration and execution. #50

Bug Fixes

• Fix installation instructions to use npx -y skills without the unavailable global installer, and document the current Node.js 22.20+ requirement. #52

Maintenance

• Reuse established connection and schema context, preserve existing designs during scoped edits, and make validation proportional to the requested work. #51
• Consolidate the README into one installation section and one complete catalog, with detailed operations in the install guide. #52

Tooling and Release

• Add release-note drift auditing and product-contract validation; synchronize version 2.6.0 across the supported plugin and extension packages. #50
• Remove obsolete validator requirements for a fixed skill-routing sequence and the unavailable installer package. #51, #52

Compatibility

• Existing skill names remain available, and explicitly requested structured JSON keeps the same five top-level keys. Shared instructions remain model-neutral. #51
• The Skills CLI installation route requires Node.js 22.20+; native plugin and extension routes use their host requirements. #52

Verification

• The skill refresh passed six Astra use-case evaluations, six TypeScript artifacts, and the MotherDuck-backed examples and dlt/dbt reference pipeline. #51
• The release target passed hosted catalog and package validation; local release checks also passed version consistency, both plugin sync checks, manifest validation, 1,047 snippets, and Gemini archive generation. Main CI

Full diff: v2.5.0...v2.6.0

v2.5.0

Highlights

• Dives now have a dedicated mobile-first design workflow with light/dark theming, durable filter capacity, reusable customer boundaries, and restrained business-analytics styling. #49
• The workflow includes a repeatable screenshot, inspection, iteration, and reviewer-handoff loop for desktop and mobile quality. #49

Features

• Added motherduck-design-dive, its responsive design system, and its visual-QA playbook. #49
• Routed dashboard and Dive creation guidance through the new design skill and modernized the responsive examples. #49

Bug Fixes

• Pinned live MotherDuck artifact checks to a supported, overridable DuckDB version so release validation does not accidentally select an unsupported client. #49

Maintenance

• Synchronized Claude, Codex, Gemini, Cursor, catalog, documentation, and user-agent surfaces at version 2.5.0. #49

Tooling and Release

• Published the Gemini extension archive from the verified merged commit. Release workflow

Compatibility

• No breaking changes are expected; existing skill names remain available, and the new workflow composes with motherduck-create-dive and motherduck-build-dashboard. #49

Verification

• Hosted skill/plugin validation, snippet validation, version consistency, packaging, and release publication completed successfully. Release workflow
• Live MotherDuck artifacts, the dlt/dbt reference pipeline, and responsive Dive QA at 320, 375, and 1440 px passed before merge. #49

Full diff: v2.4.0...v2.5.0

v2.4.0

Highlights

• Make the public skill catalog leaner, discovery-first, and explicit about safe action boundaries for GPT-5.6-style agents. #48
• Add an MCP-first administration guide for service accounts, tokens, Ducklings, and embedded Dive sessions. #47

Features

• Add current MotherDuck MCP administration routing and reference guidance to motherduck-rest-api. #47

Bug Fixes

• Isolate Codex use-case regressions from unrelated user MCP configuration, add timeouts, and support explicit model selection. #48
• Fully qualify the dlt/dbt pipeline validation queries and lock TypeScript snippet validation to the repository version. #48

Maintenance

• Remove duplicated trigger prose and drift-prone plan, version, browser-size, and runtime-capacity claims while preserving live-verification routes. #48

Tooling and Release

• Synchronize Claude, Codex, Cursor, Gemini, and marketplace surfaces and bump all manifests and workload watermarks to 2.4.0. #48

Compatibility

• No breaking changes are expected; existing skill names, layer dependencies, artifacts, and structured JSON contracts are preserved. #48

Verification

• Required PR checks passed, and the tag workflow revalidated version consistency, skill manifests, plugin sync, and the Gemini release archive. #48 Release workflow

Full diff: v2.3.0...v2.4.0

v2.3.0

What's Changed

• Rename motherduck-examples → motherduck-cookbook references by @mehd-io in #45
• Release v2.3.0 by @github-actions[bot] in #46

New Contributors

• @github-actions[bot] made their first contribution in #46

Full Changelog: v2.2.2...v2.3.0

v2.2.2

Security maintenance release.

Security

• Resolved all 24 open Dependabot alerts (8 unique advisories, 21 high / 3 moderate) by bumping three transitive dependencies in the dlt-dbt-motherduck-project reference lockfile. Direct deps (dbt-duckdb, dlt, duckdb) unchanged. (#43)

Package	Before → After	Advisories
GitPython	3.1.46 → 3.1.50	GHSA-rpm5-65cw-6hj4, GHSA-x2qx-6953-8485, GHSA-7545-fcxq-7j24, GHSA-v87r-6q3f-2j67, GHSA-mv93-w799-cj2w
urllib3	2.6.3 → 2.7.0	GHSA-mf9v-mfxr-j63j, GHSA-qccp-gfcp-xxvc
idna	3.11 → 3.18	GHSA-65pc-fj4g-8rjx

Release engineering

• Version bumped to 2.2.2 across all manifests, INTEGRATION_VERSION, and agent-skills/<version> watermarks. (#44)

Full changelog: v2.2.1...v2.2.2

v2.2.1

This release adds first-class support for MotherDuck Flights plus documentation polish.

New skills

• motherduck-create-flight — create, schedule, run, and debug MotherDuck Flights (Python jobs that run on MotherDuck compute) for scheduled ingestion and transformation. Ships a condensed flights reference (anatomy, runtime limits, config vs secrets, scheduling, versioning, the full MCP tool surface, and troubleshooting) and three ready-to-deploy templates: dlt ingestion, Postgres mirror, and scheduled S3 partition refresh. (#41)

Docs

• README now leads with install, dedupes the catalog listing, and adds a release badge. (#40)

Release engineering

• Version bumped to 2.2.1 across all manifests, INTEGRATION_VERSION, and agent-skills/<version> watermarks. (#42)

Full changelog: v2.2.0...v2.2.1

v2.2.0

First tagged, multi-host release of MotherDuck Skills for AI Agents — the curated skill catalog packaged for Claude Code, Codex, Cursor, Copilot, and the Gemini CLI. This note backfills the arc from the initial repo through the introduction of tag-driven releases.

Skill catalog

• Full three-layer catalog (utility / workflow / use-case) covering connect, explore, query, DuckDB SQL, load-data, model-data, share-data, create-dive, ducklake, security-governance, pricing-roi, and the use-case skills (CFA app, dashboard, data pipeline, migration, self-serve analytics, partner delivery). (#1, #4)
• All skill names prefixed with motherduck- for namespace clarity. (#14)
• Added the REST API administration skill for service accounts, tokens, and Duckling config. (#15)
• motherduck-connect reworked with opinionated DuckDB runtime selection guidance. (#22)
• All 18 skills tuned for current frontier models — tighter routers, MotherDuck-specific behavior over general concepts. (#38)
• motherduck-model-data now emits a file-based project scaffold; motherduck-create-dive handles namespace conflicts. (#11, #9)

Packaging & distribution

• Gemini CLI extension support and hardened plugin packaging. (#2, #7)
• README split into human- and agent-facing docs, with Cursor and Copilot install paths. (#7, #19)

Release engineering

• Added the repo-wide version bump script and tag-driven release CI (workflow_dispatch opens a release PR; pushing vX.Y.Z publishes the GitHub release and attaches the Gemini archive). (#39)
• CI updated for Node 24. (#37)

Version surfaces aligned at 2.2.0 across all manifests, INTEGRATION_VERSION, and agent-skills/<version> watermarks. (#20)