Rails Upgrade

Detecta cambios importantes en Rails y genera informes de actualización de salto de versión para Rails 2.3-8.1

Por ombulabs · ombulabs/claude-code_rails-upgrade-skill

Probado · Funciona ★ 8.8/10

Rails Upgrade — Detecta cambios importantes en Rails y genera informes de actualización de salto de versión para Rails 2.3-8.1

Qué hace

Analiza una base de código Rails contra archivos de patrones grep específicos de la versión para encontrar cambios importantes, deprecaciones y elementos de migración, luego los compila en un informe de actualización categorizado con correcciones por hallazgo para cualquier salto secuencial de Rails 2.3 a 8.1. Se activa cuando el usuario solicita actualizar una aplicación Rails, planificar una actualización de varios saltos o consultar cambios importantes en una versión específica de Rails. Impone actualizaciones secuenciales (sin saltos) y delega el trabajo de dual-boot y load_defaults a habilidades complementarias.

Informe de la prueba

Localicé SKILL.md en rails-upgrade/SKILL.md (el repositorio tiene dos habilidades; el slug coincide con este directorio). El frontmatter se analiza con name+description; verifiqué 3 archivos referenciados en el cuerpo (direct-detection-workflow.md, rails-70-patterns.yml, upgrade-report-template.md), todos HTTP 200; sin problemas de seguridad. Para la salida, construí una aplicación Rails 6.1 de prueba (Gemfile con webpacker/spring/turbolinks/ruby 2.6.5, una vista form_with local:true, Rails.application.secrets en un controlador, un modelo enum) y ejecuté el direct-detection-workflow de la habilidad buscando cada patrón en rails-70-patterns.yml: los 7 patrones coincidieron con file:line exactos. La línea base (mi propio conocimiento de Rails, sin habilidad) detectó las categorías principales pero no dio anclaje de archivo y omitió los hallazgos de secrets.yml y enum que la habilidad mostró con líneas y matices precisos de la versión (ej. secrets funciona en 7.0 pero está obsoleto en 7.1).

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/ombulabs/claude-code_rails-upgrade-skill.git /tmp/rails-upgrade-src
mkdir -p ~/.claude/skills
cp -R /tmp/rails-upgrade-src/rails-upgrade ~/.claude/skills/rails-upgrade
# SKILL.md lands at ~/.claude/skills/rails-upgrade/SKILL.md
# Optional companion skills for the full end-to-end workflow (not needed for detection/report):
#   dual-boot skill        -> github.com/ombulabs/claude-code_dual-boot-skill (Step 2)
#   rails-load-defaults    -> github.com/ombulabs/claude-code_rails-load-defaults-skill (Step 7)
#   upgrade-cleanup plugin -> shipped in /tmp/rails-upgrade-src/upgrade-cleanup (Step 8)
# Full upgrade execution also needs the target Rails app checked out with a runnable test suite.

Comandos y prompts de ejemplo

/rails-upgradeDetecta cambios importantes en Rails y genera informes de actualización de salto de versión para Rails 2.3-8.1

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Plan our upgrade from Rails 6 to Rails 7
What breaks when we upgrade to Rails 7.1
Generate a migration guide for this Rails hop

Informe completo →