AIKraft/Skills/migrate-radix-to-base

migrate-radix-to-base

Мигрирует React-проекты и компоненты из Radix UI в Base UI. Подходит, когда нужно конвертировать radix-примитивы или сменить базовую библиотеку в shadcn-проекте. Обрабатывает как отдельные компоненты, так и целые проекты.

shadcn 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.

Как работает

  1. Выполнить preflight: проверить текущую базу через npx shadcn@latest info, определить пакетный менеджер, убедиться в чистоте git-дерева и базовой работоспособности сборки.
  2. Классифицировать компоненты: для shadcn-обёрток использовать CLI shadcn для получения «золотой пары» (stock origin) и применения трёхстороннего слияния (git merge-file) или прямого добавления через shadcn add.
  3. Применить обязательный поиск остатков (leftover sweep) через grep для выявления оставшихся импортов radix-ui в каждом файле, даже если слияние прошло чисто.
  4. Для кастомизированных обёрток воспроизвести диф пользователя на базовый вариант Base UI, чтобы сохранить их изменения; для не-шадцн кода использовать трансформационный движок (universal-patterns.md, props tables).
  5. Мигрировать потребителей (consumers) по одному, обновляя импорты и пропсы согласно consumer-props.md, проверяя типизацию (typecheck) после каждого шага.
  6. Сгенерировать отчёт в .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 и совместимые) подхватывает его по описанию и следует шагам.