{
  "markdown": "<h1><img src=\"assets/duck_skills.png\" alt=\"MotherDuck Skills\" height=\"80\" align=\"center\" /> MotherDuck Skills</h1>\n\n[![Latest release](https://img.shields.io/github/v/release/motherduckdb/agent-skills)](https://github.com/motherduckdb/agent-skills/releases/latest)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n22 skills for coding agents working with [MotherDuck](https://motherduck.com): connect applications, query real data with DuckDB SQL, build Dives and Flights, and deliver analytics pipelines and apps.\n\nEach skill includes focused instructions and, where useful, detailed references and runnable examples. Installing the skills does not configure a MotherDuck connection or MCP server.\n\n## Install\n\nChoose one route for your agent. Run commands beginning with `/` inside the agent; run the others in your terminal.\n\n| Agent | Install |\n| --- | --- |\n| Claude Code / GitHub Copilot CLI | `/plugin marketplace add motherduckdb/agent-skills`, then `/plugin install motherduck-skills@motherduck-skills` |\n| Codex | `codex plugin marketplace add motherduckdb/agent-skills`, then open `/plugins` and install **MotherDuck Skills** |\n| Gemini CLI | `gemini extensions install https://github.com/motherduckdb/agent-skills` |\n| Cursor / VS Code / other supported agents | Use the Skills CLI below |\n\nThe [Skills CLI](https://github.com/vercel-labs/skills) needs Git and Node.js 22.20+ ([package requirements](https://github.com/vercel-labs/skills/blob/main/package.json)). No global CLI installation is needed:\n\n```bash\nnpx -y skills add motherduckdb/agent-skills\n```\n\nSelect the skills and agents interactively. To install the whole catalog for Cursor:\n\n```bash\nnpx -y skills add motherduckdb/agent-skills --agent cursor --skill '*' --yes --global\n```\n\nUse `--agent github-copilot` for VS Code/GitHub Copilot, or another supported agent name. Omit `--global` for a project-scoped install.\n\nSee the [install matrix](docs/install-matrix.md) for alternatives, updates, verification, and manual installation. [Harness support](HARNESSES.md) documents the discovery paths and plugin manifests.\n\n## Use the Skills\n\nAsk for the task directly, or name a skill from the catalog:\n\n> Use motherduck-connect to choose the connection path for this app.\n\n> Explore my MotherDuck workspace and build a sales dashboard as a Dive.\n\n> Plan a migration to MotherDuck with validation and rollback steps.\n\nFor live work, configure [MotherDuck MCP](https://motherduck.com/docs/key-tasks/ai-and-motherduck/mcp-setup/) or an authenticated database client. Supply credentials through your normal secret or environment setup, never in prompts or committed files.\n\nStart 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.\n\n## Skills Overview\n\n**Utility** skills handle individual operations; **workflow** skills cover specific MotherDuck capabilities; **use-case** skills combine them for end-to-end work.\n\n| Skill | Layer | Use it for |\n| --- | --- | --- |\n| `motherduck-connect` | Utility | Connections, authentication, client selection, and read scaling |\n| `motherduck-cli` | Utility | Terminal queries and file-based Dive/Flight workflows |\n| `motherduck-explore` | Utility | Databases, schemas, shares, and sample data |\n| `motherduck-query` | Utility | Writing, executing, and optimizing analytical SQL |\n| `motherduck-duckdb-sql` | Utility | DuckDB syntax and MotherDuck feature support |\n| `motherduck-rest-api` | Utility | Service accounts, tokens, Ducklings, and embed sessions |\n| `motherduck-load-data` | Workflow | Bulk ingestion from files, storage, or external systems |\n| `motherduck-model-data` | Workflow | Analytical schemas and transformation models |\n| `motherduck-manage-guides` | Workflow | Business definitions and reusable warehouse context |\n| `motherduck-share-data` | Workflow | Share audiences, grants, table filters, and refresh policy |\n| `motherduck-create-dive` | Workflow | Creating, editing, publishing, sharing, or embedding Dives |\n| `motherduck-create-flight` | Workflow | Running and scheduling Python jobs on MotherDuck |\n| `motherduck-design-dive` | Workflow | Dive layout, responsive behavior, themes, and accessibility |\n| `motherduck-ducklake` | Workflow | DuckLake storage choices and operations |\n| `motherduck-security-governance` | Workflow | Permissions, isolation, residency, and compliance |\n| `motherduck-pricing-roi` | Workflow | Costs, plan fit, and ROI |\n| `motherduck-build-cfa-app` | Use-case | Customer-facing analytics with tenant isolation |\n| `motherduck-build-dashboard` | Use-case | A dashboard's analytical story, metrics, and section queries |\n| `motherduck-build-data-pipeline` | Use-case | Ingestion-to-serving pipelines |\n| `motherduck-migrate-to-motherduck` | Use-case | Migration, reconciliation, cutover, and rollback |\n| `motherduck-enable-self-serve-analytics` | Use-case | Governed analytics for internal teams |\n| `motherduck-partner-delivery` | Use-case | Repeatable delivery across client engagements |\n\nBrowse the [source skills](skills/) or the [machine-readable catalog](skills/catalog.json).\n\n## Troubleshooting\n\n- **Skill not discovered:** check that it is installed for the agent you are using, reload the agent, and name the skill explicitly.\n- **Live queries fail:** verify the MCP server or database connection and its credentials. Skills provide guidance, not account access.\n- **PostgreSQL-only syntax:** use `motherduck-duckdb-sql`. PostgreSQL wire compatibility does not change the SQL dialect.\n\n## Contributing\n\nEdit source skills under `skills/`; the `plugins/` directories contain generated packages. See [CONTRIBUTING.md](CONTRIBUTING.md) for checks and package synchronization, [skill authoring](docs/skill-authoring.md) for conventions, and [ARCHITECTURE.md](ARCHITECTURE.md) for catalog rules.\n\nReleases use the [release process](docs/release-process.md) and `scripts/bump_version.py`; do not edit version numbers by hand.\n\n## Resources\n\n- [MotherDuck documentation](https://motherduck.com/docs/)\n- [DuckDB documentation](https://duckdb.org/docs/)\n- [Agent Skills specification](https://agentskills.io)\n\n## License\n\n[MIT](LICENSE).\n",
  "bytes": 6360,
  "sha": "5f22a531f9e79830131074c4394ff018c5e3b221fae5a7eacadba2597036c17a",
  "repo_slug": "motherduckdb/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_motherduckdb_agent_skills_386d28e7/readme"
}