chakra-ui-migrate

Что делает навык

Навык помогает мигрировать проекты Chakra UI с версии 2 на 3, включая обновление пакетов, настройку провайдеров, работу с цветовой темой, переименование пропсов и адаптацию компонентов. Он устраняет ломающие изменения и решает проблемы с устаревшими паттернами v2.

Когда применять

• Обновление версий Chakra UI для устранения ломающих изменений
• Миграция провайдеров и настройки темы с extendTheme на createSystem
• Замена устаревших компонентов (например, Modal на Dialog) и пропсов
• Адаптация цветовой темы и удаление ColorModeScript в пользу next-themes
• Обновление зависимостей и удаление пакетов, больше не требуемых в v3

Как работает

1. Проверить проект: прочитать package.json и ключевые файлы, чтобы определить текущую версию, фреймворк и менеджер пакетов
2. Обновить пакеты: удалить устаревшие зависимости (@chakra-ui/icons, @emotion/styled и др.) и установить @chakra-ui/react и @emotion/react
3. Запустить codemod: выполнить npx @chakra-ui/codemod upgrade для автоматического обновления импортов и пропсов
4. Обновить Provider: заменить ChakraProvider на новый Provider из snippets и настроить тему через createSystem
5. Мигрировать цветовую тему: удалить ColorModeScript и использовать семантические токены или next-themes
6. Проверить переименования пропсов и компонентов: вручную проверить изменения после codemod, особенно для Dialog, Field и Compound Components

Примеры запросов агенту

Что понадобится

• Node.js >= 20.x
• Доступ к репозиторию Chakra UI и его документации
• Наличие проекта с Chakra UI v2 для миграции

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.