rails-upgrade — скилл для Claude Code: что делает и как установить
Скилл оценивает сложность обновления Ruby on Rails, сверяет конфигурации через railsdiff.org и готовит пошаговый план без слепой перезаписи файлов.
npx skills add robzolkos/skill-rails-upgrade --skill rails-upgrade -a claude-codeЧто делает rails-upgrade
Скилл проверяет структуру проекта по файлам Gemfile, config/application.rb и config/environment.rb, после чего находит установленную версию фреймворка в Gemfile.lock. Через GitHub CLI он запрашивает свежий тег в репозитории Rails и классифицирует обновление: патч, минорный или мажорный релиз.
Затем агент скачивает официальное руководство по миграции и забирает диффы конфигов с railsdiff.org. Он изучает зависимости JavaScript в package.json или config/importmap.rb, чтобы подтянуть Turbo, Stimulus и другие связанные библиотеки. Без установленной утилиты gh проверить свежие релизы через терминал не получится.
Главное отличие от штатной команды rails app:update — выборочное слияние правок. Скилл сохраняет ваши локальные настройки в инициализаторах и скриптах bin/, формируя понятный отчёт с оценкой сложности и списком изменений.
Какие задачи решает
- Оценить сложность перехода на свежую версию Rails
- Сравнить текущие конфигурационные файлы с эталоном через diff
- Найти устаревшие зависимости JavaScript вроде Turbo и Stimulus
- Подготовить план миграции без потери локальных настроек
Примеры запросов агенту
- Проанализируй проект и составь план обновления Rails до актуальной версии
- Проверь совместимость библиотек в package.json перед миграцией Rails
- Помоги обновить конфигурационные файлы без перезаписи моих настроек
Как установить rails-upgrade
1Через Skills CLI (Vercel)
npx skills add robzolkos/skill-rails-upgrade --skill rails-upgrade -a claude-code2Вручную: положить файлы
~/.claude/skills/rails-upgrade/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rails-upgrade/
1Через Skills CLI (Vercel)
npx skills add robzolkos/skill-rails-upgrade --skill rails-upgrade -a codex2Вручную: положить файлы
.agents/skills/rails-upgrade/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add robzolkos/skill-rails-upgrade --skill rails-upgrade -a cursor2Вручную: положить файлы
.cursor/skills/rails-upgrade/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install robzolkos/skill-rails-upgrade rails-upgrade2Вручную: положить файлы
.github/skills/rails-upgrade/SKILL.md1Через Skills CLI (Vercel)
npx skills add robzolkos/skill-rails-upgrade --skill rails-upgrade -a gemini-cli2Командой платформы
gemini skills install https://github.com/robzolkos/skill-rails-upgradeВручную: положить файлы
.devin/skills/rails-upgrade/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add robzolkos/skill-rails-upgrade --skill rails-upgrade -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о rails-upgrade
Как установить rails-upgrade в Claude Code?
Запустите команду npx skills add robzolkos/skill-rails-upgrade --skill rails-upgrade -a claude-code. Конфигурация сохранится по пути ~/.claude/skills/rails-upgrade/SKILL.md.
Что делает rails-upgrade?
Скилл анализирует версию фреймворка, сопоставляет её с последним релизом, подтягивает официальное руководство и показывает различия в конфигурации.
Почему скилл не рекомендует запускать rails app:update?
Стандартная команда часто затирает ручные правки в конфигурации, поэтому инструмент предлагает выборочно переносить только нужные строки.
