Rails Upgrade Assistant

A Claude Code skill for upgrading Ruby on Rails applications.

Acknowledgments

This skill is inspired by rails-upgrade-skill by Mario Alberto Chávez Cárdenas. His original work has been merged into the addenda.

Contributing

Add your learnings to addenda/ files and submit a PR.

Use your coding agent to extract upgrade tips from your own Rails app's git history. When you've successfully upgraded your app, those hard-won lessons can help everyone. Your real-world migration experience—the edge cases, gotchas, and solutions you discovered—becomes collective knowledge that makes future upgrades smoother for the entire community.

Install

cd ~/.claude/skills
git clone git@github.com:dkam/railsup.git

Claude Code will automatically find the skill.

Update

cd ~/.claude/skills/railsup
git pull

Usage

Auto-activation

Claude activates when you ask about Rails upgrades, planning upgrades, or investigating version-specific issues.

Manual invocation

# Specify target version
/railsup 8.1

# Auto-detect and prompt
/railsup upgrade

What It Does

1. Analyzes your Rails application for breaking changes
2. Generates detection scripts to scan your codebase
3. Provides comprehensive upgrade reports with step-by-step migration guides
4. Flags custom code and potential issues
5. Offers to apply fixes directly

Supported Versions

Rails 3.0 through 8.2