👉 Visit the DatoCMS homepage or see What is DatoCMS?
A collection of agent skills that teach Claude, Codex, Cursor, and other coding agents how to work effectively with DatoCMS — from GraphQL queries and content management scripts to content modeling, plugin development, and one-shot project setup.
All open source, with native plugin support on Claude Code and Codex and a universal npx skills installer for everything else.
DatoCMS offers two AI integrations and they don't overlap:
- MCP server — for editors and PMs who want an agent to read and update a project from anywhere (web, mobile, no local setup).
- Agent Skills (this repo) — for developers in their editor or CLI. A superset of MCP: every MCP capability is reachable here via
npx datocms …, plus content modeling, frontend integrations, migrations, plugin development, and more.
If you're shipping code, you want Skills.
The skills are designed to work together — they cross-link and reinforce each other, so the default install brings the full set. Most trigger automatically based on your prompt; datocms-setup is invoked explicitly.
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 with filters, pagination, localization, Structured Text, responsive images, SEO, and typed queries.
- Writing content & automation — record CRUD, bulk imports/exports, asset uploads, environment forks and promotions, webhooks, roles, scheduled publishing, audit logs.
- CLI workflows — migrations, schema-type generation, typed CMA scripts, CI/CD pipelines, WordPress/Contentful imports.
- Frontend integrations — draft mode, Web Previews, Visual Editing, Content Link, real-time preview subscriptions, cache-tag invalidation, SEO/sitemap wiring across Next.js, Nuxt, SvelteKit, and Astro.
- One-shot setup (
datocms-setup) — the only skill you invoke explicitly. Bootstraps multi-step flows like "set up visual editing" in a single command, queueing prerequisites automatically.
Extending the DatoCMS dashboard
- Plugin scaffolding — bootstrap a brand-new plugin (Vite/React, initial surfaces).
- Plugin maintenance — patch and extend an existing plugin: hooks, field extensions, sidebars, validations.
- Plugin design system — restyle plugin UI to feel native to the DatoCMS dashboard.
For the full list of skill names, internal setup recipes, and routing rules see docs/skill-catalog.md.
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.
/plugin marketplace add datocms/agent-skills
/plugin install datocms@datocms-skillsSkills are namespaced under the plugin (e.g. /datocms-cda). Enable auto-update from /plugin → Marketplaces → datocms-skills, or update manually with claude plugin update datocms@datocms-skills.
codex plugin marketplace add datocms/agent-skillsThen open a Codex session and install from the plugin picker:
/pluginsChoose DatoCMS and "Install plugin"
npx skills add datocms/agent-skillsUpdate later with npx skills update. For scopes, single-skill installs, and detached snapshots see docs/install.md.
On the web you can't run CLI commands or edit local files, so most development-focused skills don't apply. The ones worth uploading are datocms-content-modeling.zip (content modeling) and datocms-cma.zip (writing content & automation) — best paired with the DatoCMS MCP server, which lets the agent read and update your project directly from the conversation.
Upload the .zip files via Customize → Skills in claude.ai. The full set of pre-built zips lives in the zips/ folder.
You don't need to invoke the auto-triggered skills — describe what you want in plain language and the right one activates:
- "Should testimonials be a model or a block?"
- "How should I structure a multi-locale schema with shared blocks?"
- "Write a GraphQL query to fetch all blog posts with images"
- "How do I paginate past the 100-record limit?"
- "Add draft mode to my Next.js app"
- "Why isn't my Visual Editing overlay showing up?"
- "Create a migration that adds a
categoryfield to the blog_post model" - "What's the safest way to run a migration in production?"
- "Bulk-publish all draft records of type
article" - "Publish them"
- "Fix those slugs"
- "Import this CSV into the authors model"
- "Make my plugin config screen match the DatoCMS style"
- "Create a new DatoCMS plugin from scratch"
datocms-setup is the only skill you invoke explicitly. It handles one-shot project bootstrapping (draft mode, visual editing, migrations workflows, content imports, etc.) and queues prerequisites automatically when needed.
| Platform | Invocation |
|---|---|
| Claude Code | /datocms-setup <your request> |
| Codex | $datocms-setup <your request> |
Phrase the prompt as the outcome you want. Terms like content link, visual editing, click-to-edit, or draft mode help the router pick the right recipe.
/datocms-setup install visual editing in this project
/datocms-setup set up draft mode and web previews
/datocms-setup add migrations and a release workflow
/datocms-setup set up click-to-edit overlays for draft pages
If a prerequisite is missing (e.g. draft mode is needed before web previews), setup queues it in the same run instead of requiring a second call.
Every recipe ends with one of two statuses: scaffolded if it still contains placeholders you need to fill in (API tokens, route mappings, model-to-URL maps, TODO stubs), or production-ready if it's wired to real project values and works end-to-end with no further edits. No guessing whether the output is ready to ship.
For the full recipe catalog and routing rules see docs/skill-catalog.md.
docs/install.md— installation reference (scopes, single-skill installs, detached snapshots, update mechanics)docs/skill-catalog.md— full skill catalog, internal setup recipes, and routing rulesdocs/repo-layout.md— repository layout and the reasoning behind itdocs/maintenance.md— contributor and maintainer workflows (validation, regenerating zips, release notes)evals/README.md— trigger-quality evaluation framework
Issues and pull requests are welcome on github.com/datocms/agent-skills. See docs/maintenance.md for the contributor workflow.
DatoCMS is the REST & GraphQL Headless CMS for the modern web.
Trusted by over 25,000 enterprise businesses, agencies, and individuals across the world, DatoCMS users create online content at scale from a central hub and distribute it via API. We ❤️ our developers, content editors and marketers!
Why DatoCMS?
- API-First Architecture: Built for both REST and GraphQL, enabling flexible content delivery
- Just Enough Features: We believe in keeping things simple, and giving you the right feature-set tools to get the job done
- Developer Experience: First-class TypeScript support with powerful developer tools
Getting Started:
- ⚡️ Create Free Account - Get started with DatoCMS in minutes
- 🔖 Documentation - Comprehensive guides and API references
- ⚙️ Community Support - Get help from our team and community
- 🆕 Changelog - Latest features and improvements
Official Libraries:
- Content Delivery Client - TypeScript GraphQL client for content fetching
- REST API Clients - Node.js/Browser clients for content management
- CLI Tools - Command-line utilities for schema migrations (includes Contentful and WordPress importers)
Official Framework Integrations
Helpers to manage SEO, images, video and Structured Text coming from your DatoCMS projects:
Additional Resources:
- Plugin Examples - Example plugins we've made that extend the editor/admin dashboard
- Starter Projects - Example website implementations for popular frameworks
- All Public Repositories