rails-upgrade

Automate Ruby on Rails application upgrades across multiple versions with detection scripts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the complex and time-consuming process of upgrading Ruby on Rails applications to newer versions, ensuring a smooth transition by identifying breaking changes, providing fixes, and generating comprehensive reports.

Core Features & Use Cases

  • Version-Specific Analysis: Detects breaking changes, deprecations, and configuration updates for specific Rails versions.
  • Automated Workflow: Guides users through a mandatory, sequential upgrade process (tests → load_defaults → detection → reports).
  • Use Case: A developer needs to upgrade a Rails 5.2 application to Rails 8.0. This Skill will break down the process into manageable hops, identify necessary code changes for each version jump (like Zeitwerk for 6.0 or Propshaft for 8.0), and provide actionable reports.

Quick Start

Use the rails-upgrade skill to help upgrade my Rails app from version 7.1 to 7.2.

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 across multiple versions?

To upgrade your Rails app across multiple versions, break the process into sequential version hops for each major release. Analyze deprecations and configuration updates at each step to ensure compatibility and adherence to best practices.

What is the best way to identify breaking changes during a Rails upgrade?

Identifying breaking changes during a Rails upgrade is best handled by running detection scripts against the target version. These scripts analyze your codebase to flag necessary configuration updates and deprecations.

How do I upgrade a Rails 5.2 application to Rails 8.0?

To upgrade a Rails 5.2 application to Rails 8.0, execute sequential version hops like 6.0, 7.0, and 8.0. Handle specific framework shifts at each stage, such as migrating to Zeitwerk for 6.0 or Propshaft for 8.0.

Do I need to run tests before applying load_defaults during a Rails migration?

Yes, running tests before applying load_defaults during a Rails migration is required. A sequential upgrade workflow mandates passing tests first, then loading defaults, running detection, and generating reports.

Can I skip intermediate versions when upgrading a Ruby on Rails application?

Skipping intermediate versions when upgrading a Ruby on Rails application is not recommended. The process requires manageable hops between consecutive versions to accurately address specific breaking changes and configuration updates.

Why does the Rails upgrade process require step-by-step guidance for each version?

The Rails upgrade process requires step-by-step guidance because each version introduces unique breaking changes like Zeitwerk or Propshift. Sequentially addressing these ensures code compatibility and prevents overwhelming refactoring efforts.