Terminal
Terminal/Skill
Builds, maintains and restyles DatoCMS plugins using the plugin SDK and React UI kit, including hooks, field editors, sidebars and config screens.
By DatoCMS
Works with
npx skills add datocms/agent-skills --skill datocms-pluginPlugin code: patch in place; scaffold only when requested or absent. A project's plugin installation is CMA data, not plugin code — install, enable/disable, switch marketplace package ↔ private URL or version, edit global parameters → datocms-cma plugin operations. Local testing without touching the working installation: development copy.
package.json, package manager, scripts, plugin metadata, and installed SDK/UI versionsconnect() call, usually src/main.tsx or src/index.tsxAGENTS.md if present| Need | Load |
|---|---|
| Follow-up maintenance shortcuts | references/rapid-patterns.md |
Exact connect(), hook pairs, render helper, Canvas, frame sizing | references/sdk-connect-and-frames.md |
Base ctx, entity repos, form values, browser CMA, endpoints, async errors | references/sdk-context-and-cma.md |
| Target code has no clear precedent | references/current-plugin-patterns.md |
| Plugin permission changes | references/permissions.md |
| Localized values, field paths, Structured Text Slate form values | references/form-values.md |
| Need | Load |
|---|---|
| Project files and package baseline | references/project-scaffold.md |
| First hook pair selection | references/surface-starters.md |
| Surface | Load |
|---|---|
| Config screen | references/config-screen.md |
| Field extension | references/field-extensions.md |
| Sidebar panel or full record sidebar | references/sidebar-panels.md |
| Custom page | references/custom-pages.md |
| Dropdown action | references/dropdown-actions.md |
| Lifecycle hook | references/lifecycle-hooks.md |
| Modal | references/modals.md |
| Outlet | references/outlets.md |
| Inspector | references/inspectors.md |
| Asset source | references/asset-sources.md |
| Upload sidebar or upload panel | references/upload-sidebars.md |
| Structured Text customization | references/structured-text.md |
| Record presentation or picker query | references/record-presentation.md |
| Need | Load |
|---|---|
| Dark-mode-only migration | references/dark-mode-upgrade.md |
| First design pass | references/design-foundations.md + references/design-datocms-react-ui-bridge.md |
| Token/variable lookup | references/design-tokens.md |
| Layouts, pages, split views, toolbars | references/design-layouts.md |
| Forms, controls, settings | references/design-forms-and-controls.md |
| Dropdowns, tabs, tables, lists, notices | references/design-navigation-feedback-and-data-display.md |
| Surface shell rules | references/design-plugin-surfaces.md |
| Raw CSS fallback snippets | references/design-raw-css-fallbacks.md |
For design work, prefer public datocms-react-ui components when they match the required shape. Fall back to local React/CSS only when public components do not express the layout cleanly. Use Canvas tokens and variables directly; customize beyond them only for explicit product styling, vendor widgets, media treatments, data visualization, or effects they cannot express.
connect() call.connect() before adding hooks.datocms-react-ui/styles.css once in the plugin entry file; keep src/vite-env.d.ts (/// <reference types="vite/client" />) or TS rejects it.<Canvas ctx={ctx}>.<Canvas ctx={ctx} noAutoResizer> for pages, inspectors, and full-width sidebars.switch for ID-dispatched render hooks.import type { ... } for SDK types.ctx.item before reading saved-record data.get(ctx.formValues, ctx.fieldPath) in field extensions; use localized-value helpers elsewhere.ctx object properties.ctx.openModal() parameters and ctx.resolve() values JSON-serializable.ctx.setParameters() directly in renderManualFieldExtensionConfigScreen.rich_text in FieldType and API field_type. Do not create editor field extensions for Modular Content, single block, or Structured Text fields; use addons (Modular Content: fieldTypes: ['rich_text']; single block has no FieldType: overrideFieldExtensions, or fieldTypes: 'all' if every field type may offer it).@datocms/cma-client-browser, add only required permissions, and guard missing ctx.currentUserAccessToken.DAST analysis, validation, or transforms → datocms-structured-text: document model, editing, or conversion. Keep Slate form values and editor hooks here; never pass DAST to ctx.setFieldValue. Load the specialist only for DAST work. Missing sibling reference → install that skill from datocms/agent-skills or update the full bundle.
Website preview, Content Link, draft mode, cache tags, frontend rendering, or framework wiring -> datocms-frontend-integrations; guided multi-part website setup -> datocms-setup.
Content modeling decisions -> datocms-content-modeling.
Content delivery GraphQL query work -> datocms-cda.