rails-upgrade-assistant

Automates rail upgrade planning and delivery from 7.0 to 8.1.1.

82|9|Updated Nov 2, 2025
One-click install
npx skills add https://github.com/maquina-app/rails-upgrade-skill --skill rails-upgrade-assistant
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rails-upgrade-assistant
Source: https://github.com/maquina-app/rails-upgrade-skill/tree/main
Command: npx skills add https://github.com/maquina-app/rails-upgrade-skill --skill rails-upgrade-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the process of upgrading Rails applications by providing modular, on-demand outputs including a detection script, a comprehensive upgrade report, and an app:update preview to guide safe migrations.

Core Features & Use Cases

  • On-demand workflows: detection script, upgrade report, and app:update preview tailored to your codebase.
  • Custom code detection with ⚠️ warnings, highlighting exactly where changes are needed.
  • Multi-hop upgrade planning with clear sequencing and risk assessment.
  • Neovim MCP integration support for real-time in-editor updates (optional).

Quick Start

Use this skill to start an upgrade by saying: "Upgrade my Rails app to [target version]".
The assistant will analyze your project, load only the required workflows, and deliver a comprehensive plan and actionable steps tailored to your codebase.

Frequently Asked Questions about rails-upgrade-assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a safe Rails upgrade for my application?▼

This assistant analyzes your codebase to generate modular Rails upgrade guidance, including a detection script, a comprehensive upgrade report, and an app:update preview. It delivers code-aware recommendations and risk assessments tailored to your specific project files.

What versions of Rails does the upgrade assistant support?▼

The Rails upgrade assistant supports application upgrades from Rails 7.0 through 8.1.1. It handles both single-hop and multi-hop upgrade sequences, providing precise change recommendations based on official Rails CHANGELOG version guides.

Do I need a Rails MCP server to use the upgrade assistant?▼

Yes, you need access to a Rails MCP server because the assistant reads your actual project files to generate accurate upgrade guidance. It optionally integrates with Neovim MCP support for real-time, in-editor code updates.

How does multi-hop Rails upgrade sequencing work?▼

Multi-hop Rails upgrade sequencing works by planning a clear progression through intermediate versions. The assistant assesses risks for each hop, applies official Rails CHANGELOG-based version guides, and highlights exactly where custom code changes are needed.

Can I integrate the Rails upgrade report with Neovim for live edits?▼

Yes, the Rails upgrade assistant optionally integrates with Neovim MCP support for real-time, in-editor updates. This allows you to apply the generated upgrade guidance and custom code detections directly within your development environment.

What is included in the Rails upgrade detection script output?▼

The detection script output includes custom code detection with warnings that highlight exactly where changes are needed in your codebase. It works alongside a comprehensive upgrade report and an app:update preview to guide safe migrations.