Rails Upgrade Skill

January 27, 2026 ยท View on GitHub

A skill for Claude Code and OpenCode that analyzes Rails applications and provides comprehensive upgrade assessments.

What It Does

When invoked in a Rails project, this skill:

  1. Verifies you're in a Rails application
  2. Detects your current Rails version
  3. Fetches the latest Rails release from GitHub
  4. Classifies the upgrade type (patch/minor/major)
  5. Retrieves the official Rails upgrade guide
  6. Fetches configuration diffs from railsdiff.org
  7. Generates a comprehensive upgrade summary with complexity rating

Prerequisites

Installation

Claude Code

  1. Create the skills directory if it doesn't exist:

    mkdir -p ~/.claude/skills

  2. Clone or copy this skill to the skills directory:

    git clone https://github.com/robzolkos/skill-rails-upgrade.git ~/.claude/skills/rails-upgrade

    Or copy manually:

    cp -r /path/to/skill-rails-upgrade ~/.claude/skills/rails-upgrade

  3. Restart Claude Code to load the skill.

OpenCode

  1. Create the skill directory if it doesn't exist:

    mkdir -p ~/.config/opencode/skill

  2. Clone or copy this skill to the skill directory:

    git clone https://github.com/robzolkos/skill-rails-upgrade.git ~/.config/opencode/skill/rails-upgrade

    Or copy manually:

    cp -r /path/to/skill-rails-upgrade ~/.config/opencode/skill/rails-upgrade

  3. Restart OpenCode to load the skill.

Usage

Navigate to a Rails project directory and invoke the skill:

/rails-upgrade

The skill will analyze your Rails application and provide:

  • Version Information: Current vs latest Rails version
  • Upgrade Complexity Assessment: Small/Medium/Large rating based on multiple factors
  • Key Changes: Configuration updates, deprecations, breaking changes
  • Recommended Steps: Step-by-step upgrade process
  • Resources: Links to official guides and diffs

Example Output

### Version Information
- Current version: 7.1.3
- Latest version: 8.0.1
- Upgrade type: Major

### Upgrade Complexity Assessment: Large

| Factor | Rating |
|--------|--------|
| Version jump | Major version |
| Breaking changes | Many, significant |
| Config changes | Extensive |

### Key Changes to Address
1. New default framework defaults
2. Updated Active Record encryption
3. Kamal deployment changes
...

License

MIT