Agent Skills

github: datocms/agent-skills github datocms/agent-skills

DatoCMS Skills are expert playbooks that AI coding assistants load on demand. Without them, an AI can call DatoCMS APIs, but will guess at conventions, pick wrong field types, and miss integration patterns. With them, agents work like a senior DatoCMS developer: correct GraphQL queries, solid content modeling, idiomatic frontend integrations, clean migrations, and well-structured plugins — on the first try.

Pro tip: Skills or MCP?

  • Working in a local repo? Install Agent Skills — they're all you need. Every MCP capability is already built in via local CLI calls, plus all the expertise MCP can't carry: content modeling best practices, frontend integration patterns, migration workflows, plugin conventions, and more.

  • No local terminal? (web, mobile, chat apps) Use the MCP server instead.

Pick one, not both.

What you can do

Most skills trigger automatically based on your prompt.

Building with DatoCMS

  • Content modeling — schema-design decisions: model vs block, references vs embedded blocks, taxonomies, field shapes, validators, editor appearances.

  • Reading content — GraphQL queries against the Content Delivery API: filters, pagination, localization, modular content, Structured Text, responsive images, SEO metadata, typed queries with gql.tada or codegen.

  • Writing content & automation — programmatic CMA scripts: record CRUD, bulk imports/exports, asset uploads, environment forks and promotions, webhooks, roles and tokens, scheduled publishing, audit logs.

  • CLI workflows — migrations, schema-type generation, typed CMA scripts, environment operations, CI/CD pipelines, WordPress/Contentful imports.

  • Frontend integrations — draft mode, Web Previews, Visual Editing, Content Link overlays, real-time preview subscriptions, cache-tag invalidation, SEO/sitemap wiring across Next.js App Router, Nuxt, SvelteKit, Astro, plus react-datocms, vue-datocms, @datocms/svelte, and @datocms/astro.

Building DatoCMS plugins

  • Plugin scaffolding — create a brand-new plugin from scratch with the Vite/React structure, picking the initial surfaces (field extensions, config screens, sidebars, pages, asset sources).

  • Plugin maintenance — patch and extend an existing plugin: hook additions, field extension tweaks, sidebar/page changes, validation updates.

  • Plugin design system — restyle plugin UI to feel native to the DatoCMS dashboard — config screens, panels, modals, forms, density and spacing.

Installation

Pick the install method for your agent. Every installer brings the full set by default — the skills are cross-linked and meant to work together.

Claude Code's native plugin system bundles all DatoCMS skills with auto-update support and namespaced invocation:

Terminal window
/plugin marketplace add datocms/agent-skills
/plugin install datocms@datocms-skills

All skills install; the right one activates based on your prompt. Auto-update from /plugin → Marketplaces → datocms-skills.

CLI commands and local file editing aren't available on the web, so most development-focused skills won't apply. The two worth uploading are:

To add them, go to Customize → Skills → + → Upload a skill, and drop both .zip files.

These work best alongside the DatoCMS MCP server, which lets the agent read and update your project directly from the conversation.