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.