upgrade-react-navigation — скилл для Claude Code
Скилл ведёт агента через переход React Navigation с 6.x на 7.x или с 7.x на 8.x: правит ломающие изменения и сохраняет поведение навигации.
npx skills add react-navigation/skills --skill upgrade-react-navigation -a claude-codeЧто делает upgrade-react-navigation
Скилл включается, когда вы поднимаете мажорную версию React Navigation. Агент сначала смотрит на @react-navigation/native в package.json: для 6.x он открывает references/upgrade-6-to-7.md, для 7.x — references/upgrade-7-to-8.md. Загружается ровно один файл справки, если только вы не сравниваете версии между собой.
Дальше по этому файлу разбираются переименования и удаления в API: navigate, линковка, темы, навигаторы, опции экранов. Туда же входят обновления peer-зависимостей и инструментов. Правило простое: менять только затронутый код и брать самый простой вариант, который не ломает поведение. Шаблоны в скилле — отправная точка, а не полный список, поэтому незнакомую конструкцию агент подгоняет под ближайший образец.
Проверка идёт после правок: пакетный менеджер определяется по package.json или локфайлу, затем запускаются существующие проверка типов, линтер и тесты, если для них есть скрипты. Отдельно проходятся разделы «Automated checks» и «Manual checks» из загруженной справки. Если шаг выполнить нельзя, агент скажет почему. Без этих скриптов в проекте проверять придётся руками.
Есть и тормоз: если навигатор использует API, которых нет ни в документации, ни в справке по апгрейду, скилл останавливается и спрашивает вас до правок. Так же он поступает, когда обновление требует догадок о том, какие изменения поведения допустимы.
Какие задачи решает
- перевести проект с React Navigation 6.x на 7.x
- поднять 7.x до 8.x без поломки переходов между экранами
- найти переименованные и удалённые опции экранов
- обновить peer-зависимости и инструменты под новую мажорную версию
- проверить типы, линтер и тесты после апгрейда навигации
Примеры запросов агенту
- Обнови React Navigation до 7.x и разберись с ломающими изменениями
- Проверь
@react-navigation/nativeвpackage.jsonи примени нужную справку по апгрейду - Прогони проверку типов, линтер и тесты после обновления навигации
Как установить upgrade-react-navigation
1Через Skills CLI (Vercel)
npx skills add react-navigation/skills --skill upgrade-react-navigation -a claude-code2Вручную: положить файлы
~/.claude/skills/upgrade-react-navigation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/upgrade-react-navigation/
1Через Skills CLI (Vercel)
npx skills add react-navigation/skills --skill upgrade-react-navigation -a codex2Вручную: положить файлы
.agents/skills/upgrade-react-navigation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add react-navigation/skills --skill upgrade-react-navigation -a cursor2Вручную: положить файлы
.cursor/skills/upgrade-react-navigation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install react-navigation/skills upgrade-react-navigation2Вручную: положить файлы
.github/skills/upgrade-react-navigation/SKILL.md1Через Skills CLI (Vercel)
npx skills add react-navigation/skills --skill upgrade-react-navigation -a gemini-cli2Командой платформы
gemini skills install https://github.com/react-navigation/skills --path skills/upgrade-react-navigationВручную: положить файлы
.devin/skills/upgrade-react-navigation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add react-navigation/skills --skill upgrade-react-navigation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о upgrade-react-navigation
Как установить upgrade-react-navigation в Claude Code?
Выполните npx skills add react-navigation/skills --skill upgrade-react-navigation -a claude-code. Скилл окажется в ~/.claude/skills/upgrade-react-navigation/SKILL.md.
Что делает upgrade-react-navigation?
Проводит апгрейд React Navigation на следующую мажорную версию и закрывает обязательные ломающие изменения, сохраняя прежнее поведение навигации.
Когда скилл остановится и спросит меня?
Если навигатор использует API, которых нет в официальной документации или в справке по апгрейду, либо если для обновления нужно решить, какие изменения поведения допустимы.
