rails-upgrade

Guide incremental Rails framework upgrades with version checks and autoloader migration.

Updated Jun 13, 2026
One-click install
npx skills add https://github.com/jcuervo/rails-skills --skill rails-upgrade-jcuervo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rails-upgrade
Source: https://github.com/jcuervo/rails-skills/tree/main/rails-upgrade
Command: npx skills add https://github.com/jcuervo/rails-skills --skill rails-upgrade-jcuervo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of upgrading an existing Rails application's framework version, providing a step-by-step process to migrate to the latest version of Ruby and Rails while minimizing risk and downtime.

Core Features & Use Cases

  • Version Upgrade Path: Determines the most appropriate incremental upgrade path based on the current app version.
  • Autoloader Migration: Facilitates the transition from classic autoloader to Zeitwerk for compatibility with newer Rails versions.
  • Framework Default Adoption: Incrementally adopts new Rails defaults to maintain application consistency.
  • Modernization: Guides the application through the process of updating assets, jobs, cache, cable, and secrets for compatibility with the latest frameworks.

Quick Start

To begin upgrading your Rails application to the latest version, run 'rails upgrade' in your terminal.

Frequently Asked Questions about rails-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade my Rails app to the latest Ruby and Rails versions?

To upgrade your Rails app, this process determines the appropriate incremental upgrade path from your current version, automates autoloader migration to Zeitwerk, and incrementally adopts new framework defaults to minimize risk.

What is the best way to migrate from the classic autoloader to Zeitwerk for a Rails upgrade?

Migrating to the Zeitwerk autoloader is automated during the Rails upgrade process to ensure compatibility with newer framework versions, handling the transition from the classic autoloader smoothly without manual intervention.

How do I adopt new framework defaults incrementally during a Rails modernization?

You adopt new framework defaults incrementally by following the guided upgrade path, which updates assets, jobs, cache, cable, and secrets step by step to maintain application consistency throughout the modernization.

Can I update my legacy Rails application to the newest framework version without downtime?

Yes, the Rails upgrade process is designed to minimize risk and downtime by performing version increment checks and guiding the application through a step-by-step incremental framework version migration.

Why does my Rails upgrade require updating framework defaults for assets and cache?

Updating framework defaults for assets, jobs, cache, cable, and secrets is required during a Rails upgrade to ensure your application maintains consistency and compatibility with the latest framework versions.

When do I need to run an incremental Rails upgrade instead of jumping to the latest version?

You need an incremental Rails upgrade when moving from a legacy version, allowing you to perform version increment checks and adopt new framework defaults gradually to avoid breaking application functionality.