kirby-content-migration

Installation
SKILL.md

Kirby Content Migration

Use Kirby 6 conventions for new work. For CMS upgrades, read kirby://kb/scenarios/83-migrate-kirby-5-to-6 before planning content writes.

Schema safety

  • Inspect normalized model fields, not only raw kirby_blueprint_read configuration. hasValue: false excludes display fields; null means unresolved, not writable.
  • Never write pagelist, filelist, info, stats or buttons values. Picker selections use pagepicker, filepicker, userpicker; read their canonical update-schema guides.
  • Renaming a legacy picker type does not rename its stored key. Resolve existing targets; a new random UUID is not a relationship target.
  • Audit Symfony YAML changes in nested content: quote dates/reserved scalars and use real booleans. Invalid options now survive saves; transform removed keys explicitly.
  • Only follow actual update-schema links or entries in kirby://fields/update-schema; do not invent guides for arbitrary/display types.
  • PHP updates can accept supported objects/collections; MCP arguments still require JSON storage payloads. Check serialization, empty-number behavior and validation in kirby://kb/scenarios/84-kirby-6-core-contracts before bulk writes.

Quick start

  • Follow the workflow below for safe, confirm-first migrations.

KB entry points

Installs
7
GitHub Stars
66
First Seen
Apr 1, 2026