migrate-radix-to-base
Мигрирует React-проекты и компоненты из Radix UI в Base UI. Подходит, когда нужно конвертировать radix-примитивы или сменить базовую библиотеку в shadcn-проекте. Обрабатывает как отдельные компоненты, так и целые проекты.
AIshadcn
official
Разработка
★ 125.2k
Что делает навык
Автоматизирует миграцию React-проектов и компонентов из Radix UI в Base UI, сохраняя работоспособность сборки на каждом этапе. Обрабатывает обёртки shadcn, ручные композиции Radix и их потребителей, применяя стратегию «золотой пары» или трансформационного движка.
Когда применять
- Конвертация отдельных компонентов shadcn из Radix UI в Base UI с сохранением пользовательских кастомизаций.
- Полная миграция всего проекта shadcn с Radix на Base UI в режиме whole-project.
- Миграция проектов с устаревшими стилями (new-york, default), где нет прямого аналога Base UI, с сохранением текущего визуального вида.
- Ручная трансформация не-шадцн компонентов, использующих primitives Radix UI, через universal-patterns.
Как работает
- Выполнить preflight: проверить текущую базу через npx shadcn@latest info, определить пакетный менеджер, убедиться в чистоте git-дерева и базовой работоспособности сборки.
- Классифицировать компоненты: для shadcn-обёрток использовать CLI shadcn для получения «золотой пары» (stock origin) и применения трёхстороннего слияния (git merge-file) или прямого добавления через shadcn add.
- Применить обязательный поиск остатков (leftover sweep) через grep для выявления оставшихся импортов radix-ui в каждом файле, даже если слияние прошло чисто.
- Для кастомизированных обёрток воспроизвести диф пользователя на базовый вариант Base UI, чтобы сохранить их изменения; для не-шадцн кода использовать трансформационный движок (universal-patterns.md, props tables).
- Мигрировать потребителей (consumers) по одному, обновляя импорты и пропсы согласно consumer-props.md, проверяя типизацию (typecheck) после каждого шага.
- Сгенерировать отчёт в .migration/<component>.md с разделами Changed, Left alone, Behavior changes и Verify by hand; в конце указать количество оставшихся обёрток на Radix.
Примеры запросов агенту
Мигрируй компонент Accordion из Radix UI в Base UI, сохранив все мои кастомные стили.
Выполни полную миграцию проекта shadcn с radix-lyra на base-lyra, начиная с зависимых компонентов.
Мигрируй кастомную кнопку, использующую @radix-ui/react-slot, в Base UI, используя трансформационный движок.
Что понадобится
- Node.js и пакетный менеджер (pnpm, yarn, bun или npm), определённый через lockfile.
- Чистое git-дерево и возможность работы на отдельной ветке.
- Доступ к реестру shadcn (ui.shadcn.com) для загрузки stock origin и base-вариантов.
Описание составлено по SKILL.md навыка, сверено 06.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «shadcn-migrate-radix-to-base» из репозитория:
# https://github.com/shadcn/ui
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r shadcn-migrate-radix-to-base/ ~/.claude/skills/shadcn-migrate-radix-to-base/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.