Claude Code Rails Upgrade Skill
The one and only Claude Code Skill to Upgrade Rails by FastRuby.io -- Based on 60,000 dev/hours of experience upgrading Rails from 2.3 all the way to 8.1. Dual boot your Rails…
Install
/plugin marketplace add ombulabs/claude-skillsInstall command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →Rails Upgrade Assistant Skill
A Claude Code skill that helps you upgrade Ruby on Rails applications from version 2.3 through 8.1.
What Does This Skill Do?
The Rails Upgrade Assistant analyzes your Rails application and generates:
- Comprehensive Upgrade Reports - Detailed migration guides with OLD vs NEW code examples from your actual codebase
- app:update Previews - Shows exactly what configuration files will change when you run
rails app:update
The skill follows a sequential upgrade strategy—you upgrade one minor/major version at a time (e.g., 5.2 → 6.0 → 6.1 → 7.0), never skipping versions.
Why Trust This Skill?
This skill is built on real-world experience, not just documentation:
- 60,000+ developer hours of Rails upgrade experience
- Upgrades from Rails 2.3 to Rails 8.1 for clients worldwide
- Based on the methodology documented in "The Complete Guide to Upgrade Rails" ebook
- Created by the team at FastRuby.io, specialists in Rails upgrades since 2017
We've encountered (and solved) edge cases that don't appear in any documentation. This skill encapsulates that hard-won knowledge.
How to Use This Skill
Installation
This skill depends on two companion skills: rails-load-defaults and dual-boot. A fourth sibling plugin, upgrade-cleanup, lives in this repo and runs the post-upgrade scaffolding teardown. The marketplace install handles all four.
From inside the Claude Code CLI prompt (recommended):
/plugin marketplace add ombulabs/claude-skills
/plugin install rails-upgrade@ombulabs-ai
/plugin install rails-load-defaults@ombulabs-ai
/plugin install dual-boot@ombulabs-ai
/plugin install upgrade-cleanup@ombulabs-ai
From your terminal:
claude plugin marketplace add https://github.com/ombulabs/claude-skills.git
claude plugin install rails-upgrade@ombulabs-ai
claude plugin install rails-load-defaults@ombulabs-ai
claude plugin install dual-boot@ombulabs-ai
claude plugin install upgrade-cleanup@ombulabs-ai
Manual install:
# 1. This skill
git clone https://github.com/ombulabs/claude-code_rails-upgrade-skill.git
cp -r claude-code_rails-upgrade-skill/rails-upgrade ~/.claude/skills/
# 2. upgrade-cleanup (sibling plugin, same repo)
cp -r claude-code_rails-upgrade-skill/upgrade-cleanup ~/.claude/skills/
# 3. rails-load-defaults (dependency)
git clone https://github.com/ombulabs/claude-code_rails-load-defaults-skill.git
cp -r claude-code_rails-load-defaults-skill/rails-load-defaults ~/.claude/skills/
# 4. dual-boot (dependency)
git clone https://github.com/ombulabs/claude-code_dual-boot-skill.git
cp -r claude-code_dual-boot-skill/dual-boot ~/.claude/skills/
Basic Usage
In Claude Code, navigate to your Rails application directory and use natural language:
"Upgrade my Rails app to 7.2"
"Help me upgrade from Rails 6.1 to 7.0"
"What breaking changes are in Rails 8.0?"
Workflow
- Ask for an upgrade → Claude generates detailed reports based on your actual code
- Implement the changes → Follow the step-by-step migration plan
Available Commands
Similar plugs
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…
Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.
