migrate-shared-component

Migrate shared UI components from Kentico Xperience 13 to Xperience by Kentico.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrating a shared header/footer/navigation-style component from a legacy Kentico Xperience 13 codebase to Xperience by Kentico is hard because you must preserve both behavior and dependencies without breaking dynamic data retrieval.

Core Features & Use Cases

  • Dependency-aware migration: Locates the shared component in the source project and migrates it along with relevant dependent components/pages/services.
  • Behavior parity for dynamic content: Ensures anything that was dynamically fetched in the legacy project remains dynamically fetched in the new project to avoid incorrect hardcoding.
  • Verification with build + visual checks: Builds the target project and uses Playwright MCP to confirm the migrated UI matches the legacy rendering (styling, content, and text).

Quick Start

Run the migrate-shared-component skill and provide the shared component name and the legacy page URL where that component appears.

Frequently Asked Questions about migrate-shared-component

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

FAQPage Schema
How do I migrate shared layout components from Kentico Xperience 13 to Xperience by Kentico?

Migrating shared layout components from Kentico Xperience 13 involves porting controllers, content, and layouts while preserving dynamic data retrieval. You locate the component in the legacy project, port its dependencies, build the target project, and validate rendering via Playwright.

How do I preserve dynamic content behavior when porting headers and footers during a Kentico migration?

To preserve dynamic content behavior during a Kentico migration, you must ensure that dynamically fetched data in the legacy project remains dynamically fetched in the new project. This prevents incorrect hardcoding of values that should be retrieved at runtime.

Does migrating a shared component to Xperience by Kentico also move its dependencies?

Yes, migrating a shared component to Xperience by Kentico includes dependency-aware migration. The process locates the target component in the source project and migrates it along with relevant dependent components, pages, and services to maintain functionality.

What is the best way to verify visual parity after migrating a navigation component?

The best way to verify visual parity after migrating a navigation component is using Playwright MCP. This validates that the migrated UI matches the legacy rendering, confirming that styling, content, and text appear correctly in the new project.

Can I use Playwright to validate cross-page UI elements migrated from Kentico Xperience 13?

Yes, you can use Playwright to validate cross-page UI elements migrated from Kentico Xperience 13. The migration process uses Playwright MCP specifically to confirm that shared layout elements like breadcrumbs and headers render correctly.

What do I need to start migrating a shared header component to Xperience by Kentico?

To start migrating a shared header component, you need the shared component name and the legacy page URL where that component appears. You also need access to Xperience upgrade documentation to analyze and execute the porting process.