datocms-skills

DatoCMS Skills

Focused DatoCMS skills for content delivery, content management, CLI workflows, frontend integrations, plugin implementation, plugin UI design, and project setup. This README is the main guide for the repo.

Public Skills

• datocms-cda: read content with the DatoCMS CDA and GraphQL, including media, SEO, and typed query workflows.
• datocms-cma: write records, manage schema, environments, uploads, webhooks, and automation.
• datocms-cli: handle CLI workflows such as setup/config, migrations, schema generation, direct CMA calls, environments, deployment, multi-project sync, and imports.
• datocms-frontend-integrations: patch or extend existing frontend integrations for draft mode, previews, visual editing, rendering, and search.
• datocms-plugin-builder: patch and maintain existing DatoCMS plugins.
• datocms-plugin-design-system: design or restyle DatoCMS plugins so they feel native to the DatoCMS UI.
• datocms-plugin-scaffold: scaffold new DatoCMS plugin projects.
• datocms-setup: one-time setup orchestrator for frontend foundation/features, migrations, onboarding imports, and platform automation.

Usage

Implicit skills (7 of 8)

The first 7 skills listed above trigger automatically — you do not need to invoke them. Just describe what you want in plain language and the right skill activates based on your request.

Examples:

Write a GraphQL query to fetch all blog posts with images
                                          → triggers datocms-cda

Create a migration that adds a "category" field to the blog_post model
                                          → triggers datocms-cli

Bulk-publish all draft records of type "article"
                                          → triggers datocms-cma

Add draft mode to my Next.js app
                                          → triggers datocms-frontend-integrations

Add a sidebar panel to my plugin that shows word count
                                          → triggers datocms-plugin-builder

Make my plugin config screen match the DatoCMS style
                                          → triggers datocms-plugin-design-system

Create a new DatoCMS plugin from scratch
                                          → triggers datocms-plugin-scaffold

Setup skill (explicit only)

datocms-setup does not trigger automatically. You must invoke it explicitly:

Platform	Invocation
Claude Code	/datocms:datocms-setup <your request>
Codex	$datocms-setup <your request>

Write the prompt as the outcome you want in plain language. You do not need to know the internal recipe ids, but using terms like content link, visual editing, click-to-edit, or draft mode helps the router land on the smallest matching setup bundle.

Examples (Claude Code):

/datocms:datocms-setup install visual editing in this project
/datocms:datocms-setup set up draft mode and web previews
/datocms:datocms-setup add migrations and a release workflow
/datocms:datocms-setup set up click-to-edit overlays for draft pages

Examples (Codex):

$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

If a prerequisite is missing (e.g., draft mode is needed before web previews), the setup skill queues it in the same run instead of requiring a second call.

Inside datocms-setup, setup work is organized into five internal lanes:

• frontend-foundation: cda-client, draft-mode, web-previews, content-link, realtime, visual-editing, cache-tags, graphql-types
• frontend-features: responsive-images, structured-text, video-player, site-search, seo, robots-sitemaps
• migrations: migrations, migration-release-workflow, blueprint-sync, sandbox-iteration, cli-profiles, migration-autogenerate
• onboarding: contentful-import, wordpress-import
• platform: cma-types, webhooks, build-triggers

Setup work is reported as scaffolded when placeholders or unresolved project-specific values remain, and production-ready only when those gaps are gone.

Install

Each public skill can be installed on its own, but the full public set gives the smoothest cross-skill routing.

Claude Code (recommended)

This repo ships as a Claude Code plugin. Add the marketplace and install:

/plugin marketplace add marcelofinamorvieira/datocms-llm-skills
/plugin install datocms@datocms-skills

Skills are namespaced under the plugin name (e.g. /datocms:datocms-cda).