| name | migrate-shared-component |
| description | Migrates a reusable shared component (header, footer, navigation, breadcrumbs, etc.) from a Kentico Xperience 13 project to Xperience by Kentico. Locates the component in the source project and migrates it together with all dependencies. Use when migrating shared layout elements like headers, footers, or navigation. |
| argument-hint | Name of the shared component and the legacy page URL where it appears |
| compatibility | Requires Kentico Docs MCP and Playwright MCP |
You are tasked with the process of migrating a shared component from the legacy project to the new one.
Input Parameters
- Component Name - The name of the shared component to migrate (e.g., 'breadcrumbs', 'header').
- Legacy Page URL - The URL of the page in the KX13 project that contains the component (e.g., 'https://localhost:5001/en-us/home').
Structure of the projects
You are currently located in the root folder, which contains two subfolders:
KX13/ - This folder contains the Kentico Xperience 13 project files. This is the legacy/source project.XbyK/ - This folder contains the Xperience by Kentico project files. This is the new project.
Important
When migrating a page, ensure that everything that was fetched dynamically from the database will still be dynamically fetched from the database. Nothing can be statically hardcoded in the new project if it was dynamic in the legacy project.
Useful Documentation
- Use Kentico Docs MCP to read the following pages:
- Use web fetch to read the following pages:
Migration Steps
- Read all documentation links mentioned above.
- Review how the legacy page looks using the provided URL and identify the shared component.
- Go through files in the legacy project and identify the provided component.
- When you know the component, research how this component works and identify all other shared components, pages, or whatever this component relies on.
- If present, check how other components are implemented in the new project.
- Migrate component's controller, content, layout, and relevant components, repositories, and services to the new project, together with all dependencies identified.
- When done with implementation, ensure that the new project builds successfully without errors and warnings. If not, fix the issues until none are present.
- Using the Playwright MCP, check that the migrated component is displayed correctly and functions as expected, exactly matching styling, content, and texts as in the image of the legacy page. If not, make necessary adjustments until it does (this can also include changes in dependencies).
Whenever unsure about anything, you can use Kentico Docs MCP to search for relevant information.
Output format
When done, provide the user with this exact output (without any additional text):
# Migration Complete
Shared component migration from the legacy project to the new one has been successfully completed.
**Next steps:**
- Review the changes to ensure everything looks as expected.
- Use the migrate-page-visual skill to fix visual issues with the migration.
