Rails Upgrade Assistant
Generates Rails upgrade detection scripts and reports — solid for 7.2+, missing for the first 7.0→7.1 hop.
Test report
- Verdict
- Works with setup
- Score
- Tested
- Jul 14, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · 5fbfdff
Assembled the real Rails 7.1→7.2 detection script from the bundled pattern file and it correctly flagged all 5 planted breaking changes in a test app (vs. 2/5 for a from-memory baseline) — but the same approach dead-ends on the advertised 7.0→7.1 hop because no pattern file exists for it and 3 referenced reference/*.md files 404.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 3/5
- Triggers reliably 5/5
- Output vs. baseline 7/10
- Docs & honesty 2/5
What Rails Upgrade Assistant does
Generates a bash script that scans a Rails codebase for version-specific breaking changes with file:line references, then turns the actual findings into a comprehensive upgrade report and an app:update configuration preview. Triggers on Rails upgrade requests, breaking-change questions, or when a user shares a detection script's findings.txt. Detection patterns exist for Rails 7.2, 8.0, and 8.1 but not for the mandatory first 7.0→7.1 hop, despite the skill's own description claiming support for 'Rails 7.0 through 8.1.1'.
How to install Rails Upgrade Assistant
git clone https://github.com/maquina-app/rails-upgrade-skill
cd rails-upgrade-skill
mkdir -p ~/.claude/skills
cp -r . ~/.claude/skills/rails-upgrade-assistant
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Rails Upgrade Assistant
-
/rails-upgrade-assistantGenerates Rails upgrade detection scripts and reports — solid for 7.2+, missing for the first 7.0→7.1 hop.
It also activates on plain-language prompts like these:
-
Help me upgrade my Rails app from 7.1 to 7.2 without breaking things. -
What breaking changes should I expect moving to Rails 8.0? -
Scan my Rails codebase for issues before we upgrade the framework.
Frequently asked questions
- Is the Rails Upgrade Assistant skill free?
- Yes. The skill itself is free from maquina-app/rails-upgrade-skill. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Rails Upgrade Assistant work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 14, 2026. Verdict: Works with setup. Assembled the real Rails 7.1→7.2 detection script from the bundled pattern file and it correctly flagged all 5 planted breaking changes in a test app (vs. 2/5 for a from-memory baseline) — but the same approach dead-ends on the advertised 7.0→7.1 hop because no pattern file exists for it and 3 referenced reference/*.md files 404.
- What is the Rails Upgrade Assistant SkillProof Score?
- 6.8/10 — installs cleanly 3/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 2/5.
- How do I install Rails Upgrade Assistant?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Rails Upgrade Assistant with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.