datocms-setup
Installation
SKILL.md
DatoCMS Setup
Public setup entrypoint. Keep surface small, inspect repo first, load only needed internal recipe files.
Workflow
- Inspect repo silently before asking, follow
references/repo-conventions.md+patterns/MANDATORY_RULES.md. - Greenfield gate — if no
package.jsonand nodatocms.config.json, ask link-vs-create perpatterns/MANDATORY_RULES.md§ Project link or create before any recipe selection. On "create" → wait for confirmation, queuedatocms-content-modelingbefore any frontend recipe. - Read
references/router.md. - Read
references/recipe-manifest.json, pick smallest recipe/bundle for request. - Use targeted mode for clear setup outcomes. Discovery mode only for broad/ambiguous:
- Stage A: pick setup lane.
- Stage B: ask smallest setup-specific follow-up only when repo inspection leaves high-impact decision unresolved.
- Queue prerequisites from manifest before dependents. Never tell user to invoke separate setup skill.
visual-editing: always applydraft-mode+content-link.- Add
web-previewsunless user wants website-only click-to-edit. - Add
realtimeonly if user asks or confirms in Stage B. - Project baseline (TypeScript projects): queue
cma-typesalongsidecli-bootstrapfor any greenfield or first-time DatoCMS+TS setup. Default for a fully typed CMA experience; not opt-in.
- Load only selected
recipes/<group>/<recipe>/recipe.md, shared setup references, sibling-skill references. - Create todo list — one task per queued recipe + prerequisite, plus discrete sub-steps within each recipe (file edits, installs, env vars, verification). Mark complete as you go, never batch. Setup bundles always have many steps; todos keep progress visible and recoverable.
- Schema/modeling intent (add models, edit fields, design taxonomy) →
datocms-content-modeling. Don't improvise schema here. - Patch existing code in-place by default.
- End with
patterns/OUTPUT_STATUS.md: reportscaffoldedvsproduction-ready, summarize recipes, list unresolved placeholders.
Rules
- Don't load every recipe upfront.
- Don't use external setup bundles. Prefer sibling DatoCMS skill references over copies.
- Treat
draft-mode,web-previews,visual-editing,migration-release-workflowas internal labels. - Apply shared foundation once if outcomes overlap.
- Broad setup: ask compact Stage A, execute minimal bundle.
- Stage B only for unresolved high-impact decisions repo can't answer.
- Migration-heavy: ask smallest extra follow-up to separate baseline, profiles, histories, helpers, resets, diffs.
- Report
scaffoldedwhen recipe depends on placeholders/provider choices/routes/ownership repo couldn't resolve. - Report
production-readyonly when no unresolved customer-specific values remain. - End by summarizing used recipes and available follow-up ids inside
datocms-setup.
Related skills