migrate-classes

Generate C# IClassMapping and IReusableSchemaBuilder code from a KX13 to XbyK migration plan.

14|7|Updated Nov 25, 2025
One-click install
npx skills add https://github.com/Kentico/xperience-by-kentico-kenticopilot --skill migrate-classes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-classes
Source: https://github.com/Kentico/xperience-by-kentico-kenticopilot/tree/main/plugins/kx13-content-migration/skills/migrate-classes
Command: npx skills add https://github.com/Kentico/xperience-by-kentico-kenticopilot --skill migrate-classes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill removes the manual, error-prone effort of writing C# class-mapping and reusable-schema code needed for KX13 (Kentico Xperience 13) content migration to Xperience by Kentico, especially when page types are remodeled, merged/split, fields renamed, or values transformed.

Core Features & Use Cases

  • Generates Migration.Tool C# mappings for IClassMapping and IReusableSchemaBuilder, ready to compile in Migration.Tool.Extensions.
  • Transforms and reshapes content models using a migration-plan-driven workflow (field renames, merges/splits, value conversions, and custom code extensions).
  • Handles complex relationship scenarios such as docrelationships fields by following the CMS_Relationship conversion patterns and required factory DI approach.
  • Verifies build readiness and safety by enforcing mapping rules (including WithFieldPatch safety guardrails) and producing a post-build checklist.

Quick Start

Use migrate-classes with your migration plan path to generate the required C# class mapping files in Migration.Tool.Extensions/ClassMappings/.

Frequently Asked Questions about migrate-classes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate C# class mapping code for a KX13 to XbyK migration?

To generate C# class mapping code for a KX13 to XbyK migration, provide your migration plan path to produce compilable IClassMapping and IReusableSchemaBuilder files with DI-ready service registrations.

How does WithFieldPatch safety work when remodeling page types in XbyK?

WithFieldPatch safety enforces strict API patterns during page type remodeling to prevent data corruption, ensuring field renames, merges, and value conversions follow guardrails before producing compilable code.

Can I convert docrelationships fields to taxonomy during a Kentico Xperience migration?

Yes, you can convert docrelationships fields to taxonomy by following CMS_Relationship conversion patterns and utilizing the required factory dependency injection approach for relationship handling.

What do I need to generate reusable schema code for Kentico Xperience by Kentico?

You need a migration plan path containing lookup values and page type definitions to generate IReusableSchemaBuilder code, resolving any plan gaps via SQL queries when necessary.

Does this migration approach support page type merges and splits with field transformations?

Yes, the migration approach supports page type merges, splits, field renames, and value conversions by extracting lookup values from your plan and applying strict API patterns for safe transformations.

When should I use SQL to resolve migration plan gaps during class mapping generation?

You should use SQL to resolve migration plan gaps during class mapping generation when the plan lacks required lookup values or field definitions needed to produce compilable IClassMapping code.