Is the Rails Upgrade skill free?

Yes. The skill itself is free from ombulabs/claude-code_rails-upgrade-skill. SkillProof publishes the install command and an independent test verdict at no cost.

What is the Rails Upgrade SkillProof Score?

8.8/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 5/5.

How do I install Rails Upgrade?

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 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.

Rails Upgrade

Detects Rails breaking changes and generates version-hop upgrade reports for Rails 2.3-8.1

by ombulabs · ombulabs/claude-code_rails-upgrade-skill

Tested · Works

Install — copy the command Download source ↗

Test report

Verdict: Tested · Works
Score: 8.8/10
Tested: Jul 21, 2026
Environment: Claude Code 2.x (agent harness)
Upstream re-checked: Aug 10, 2026 · 66016d6

Located SKILL.md at rails-upgrade/SKILL.md (repo has two skills; slug matches this dir). Frontmatter parses with name+description; spot-checked 3 body-referenced files (direct-detection-workflow.md, rails-70-patterns.yml, upgrade-report-template.md), all HTTP 200; no security smells. For output I built a fixture Rails 6.1 app (Gemfile with webpacker/spring/turbolinks/ruby 2.6.5, a form_with local:true view, Rails.application.secrets in a controller, an enum model) and executed the skill's direct-detection-workflow by grepping every pattern in rails-70-patterns.yml: all 7 patterns matched with exact file:line. Baseline (my own Rails knowledge, no skill) caught the major categories but gave zero file anchoring and omitted the secrets.yml and enum findings the skill surfaced with lines and version-accurate nuance (e.g. secrets works at 7.0 but is deprecated at 7.1).

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

Installs cleanly 5/5
Triggers reliably 5/5
Output vs. baseline 7/10
Docs & honesty 5/5

What Rails Upgrade does

Analyzes a Rails codebase against version-specific grep pattern files to find breaking changes, deprecations, and migration items, then compiles them into a bucketed upgrade report with per-finding fixes for any sequential hop from Rails 2.3 to 8.1. Triggers when the user asks to upgrade a Rails app, plan a multi-hop upgrade, or query breaking changes in a specific Rails version. Enforces sequential (no-skip) upgrades and delegates dual-boot and load_defaults work to companion skills.

How to install Rails Upgrade

git clone --depth 1 https://github.com/ombulabs/claude-code_rails-upgrade-skill.git /tmp/rails-upgrade-src
mkdir -p ~/.claude/skills
cp -R /tmp/rails-upgrade-src/rails-upgrade ~/.claude/skills/rails-upgrade
# SKILL.md lands at ~/.claude/skills/rails-upgrade/SKILL.md
# Optional companion skills for the full end-to-end workflow (not needed for detection/report):
#   dual-boot skill        -> github.com/ombulabs/claude-code_dual-boot-skill (Step 2)
#   rails-load-defaults    -> github.com/ombulabs/claude-code_rails-load-defaults-skill (Step 7)
#   upgrade-cleanup plugin -> shipped in /tmp/rails-upgrade-src/upgrade-cleanup (Step 8)
# Full upgrade execution also needs the target Rails app checked out with a runnable test suite.

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Rails Upgrade

/rails-upgrade Detects Rails breaking changes and generates version-hop upgrade reports for Rails 2.3-8.1

It also activates on plain-language prompts like these:

Plan our upgrade from Rails 6 to Rails 7
What breaks when we upgrade to Rails 7.1
Generate a migration guide for this Rails hop

Frequently asked questions

Is the Rails Upgrade skill free?: Yes. The skill itself is free from ombulabs/claude-code_rails-upgrade-skill. SkillProof publishes the install command and an independent test verdict at no cost.
Does Rails Upgrade work with Claude Code?: We tested it with Claude Code 2.x (agent harness) on Jul 21, 2026. Verdict: Tested · Works. Located SKILL.md at rails-upgrade/SKILL.md (repo has two skills; slug matches this dir). Frontmatter parses with name+description; spot-checked 3 body-referenced files (direct-detection-workflow.md, rails-70-patterns.yml, upgrade-report-template.md), all HTTP 200; no security smells. For output I built a fixture Rails 6.1 app (Gemfile with webpacker/spring/turbolinks/ruby 2.6.5, a form_with local:true view, Rails.application.secrets in a controller, an enum model) and executed the skill's direct-detection-workflow by grepping every pattern in rails-70-patterns.yml: all 7 patterns matched with exact file:line. Baseline (my own Rails knowledge, no skill) caught the major categories but gave zero file anchoring and omitted the secrets.yml and enum findings the skill surfaced with lines and version-accurate nuance (e.g. secrets works at 7.0 but is deprecated at 7.1).
What is the Rails Upgrade SkillProof Score?: 8.8/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 5/5.
How do I install Rails Upgrade?: 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 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.