Skip to content

ombulabs/claude-code_rails-upgrade-skill / rails-upgrade

rails-upgrade

Verified

Analyzes Rails applications and generates comprehensive upgrade reports with breaking changes, deprecations, and step-by-step migration guides for Rails 2.3 through 8.1. Use when upgrading Rails applications, planning multi-hop upgrades, querying version-specific changes, or answering what stands between the app and the next Rails version. Based on FastRuby.io methodology and "The Complete Guide to Upgrade Rails" ebook.

FileKindSize
SKILL.mdskill md11.0 KB
detection-scripts/gem_limits.rbscript6.0 KB
detection-scripts/hop.rbscript2.2 KB
detection-scripts/patterns/rails-40-patterns.expectations.ymlconfig43.8 KB
detection-scripts/patterns/rails-40-patterns.ymlconfig96.5 KB
detection-scripts/patterns/rails-41-patterns.expectations.ymlconfig25.6 KB
detection-scripts/patterns/rails-41-patterns.ymlconfig59.8 KB
detection-scripts/patterns/rails-42-patterns.expectations.ymlconfig27.5 KB
detection-scripts/patterns/rails-42-patterns.ymlconfig48.7 KB
detection-scripts/patterns/rails-50-patterns.expectations.ymlconfig1.9 KB
detection-scripts/patterns/rails-50-patterns.ymlconfig8.1 KB
detection-scripts/patterns/rails-51-patterns.expectations.ymlconfig4.2 KB
detection-scripts/patterns/rails-51-patterns.ymlconfig15.0 KB
detection-scripts/patterns/rails-52-patterns.expectations.ymlconfig5.0 KB
detection-scripts/patterns/rails-52-patterns.ymlconfig14.7 KB
detection-scripts/patterns/rails-60-patterns.expectations.ymlconfig1007 B
detection-scripts/patterns/rails-60-patterns.ymlconfig14.2 KB
detection-scripts/patterns/rails-70-patterns.expectations.ymlconfig4.0 KB
detection-scripts/patterns/rails-70-patterns.ymlconfig11.2 KB
detection-scripts/patterns/rails-71-patterns.expectations.ymlconfig3.1 KB
detection-scripts/patterns/rails-71-patterns.ymlconfig9.5 KB
detection-scripts/patterns/rails-72-patterns.expectations.ymlconfig1.2 KB
detection-scripts/patterns/rails-72-patterns.ymlconfig6.1 KB
detection-scripts/patterns/rails-80-patterns.expectations.ymlconfig6.6 KB
detection-scripts/patterns/rails-80-patterns.ymlconfig21.2 KB
detection-scripts/patterns/rails-81-patterns.expectations.ymlconfig4.3 KB
detection-scripts/patterns/rails-81-patterns.ymlconfig13.2 KB
detection-scripts/scan_patterns.rbscript42.8 KB
examples/multi-hop-upgrade.mdmarkdown18.9 KB
examples/simple-upgrade.mdmarkdown4.0 KB
references/breaking-changes-by-version-reference.mdmarkdown3.9 KB
references/deprecation-warnings-reference.mdmarkdown10.7 KB
references/gem-compatibility-reference.mdmarkdown8.2 KB
references/js-compressor-sprockets-mismatch-reference.mdmarkdown4.7 KB
references/multi-hop-strategy-reference.mdmarkdown8.8 KB
references/next-hop-readiness-reference.mdmarkdown2.1 KB
references/no-test-suite-smoke-reference.mdmarkdown4.7 KB
references/request-patterns-reference.mdmarkdown3.7 KB
references/sequential-strategy-reference.mdmarkdown2.1 KB
references/staying-current-reference.mdmarkdown7.8 KB
references/testing-checklist-reference.mdmarkdown6.3 KB
templates/app-update-preview-template.mdmarkdown4.3 KB
templates/upgrade-report-template.mdmarkdown10.2 KB
version-guides/upgrade-3.2-to-4.0.mdmarkdown68.0 KB
version-guides/upgrade-4.0-to-4.1.mdmarkdown66.7 KB
version-guides/upgrade-4.1-to-4.2.mdmarkdown60.7 KB
version-guides/upgrade-4.2-to-5.0.mdmarkdown9.7 KB
version-guides/upgrade-5.0-to-5.1.mdmarkdown19.1 KB
version-guides/upgrade-5.1-to-5.2.mdmarkdown17.7 KB
version-guides/upgrade-5.2-to-6.0.mdmarkdown6.4 KB
version-guides/upgrade-6.0-to-6.1.mdmarkdown6.8 KB
version-guides/upgrade-6.1-to-7.0.mdmarkdown14.7 KB
version-guides/upgrade-7.0-to-7.1.mdmarkdown13.2 KB
version-guides/upgrade-7.1-to-7.2.mdmarkdown11.2 KB
version-guides/upgrade-7.2-to-8.0.mdmarkdown23.1 KB
version-guides/upgrade-8.0-to-8.1.mdmarkdown14.0 KB
workflows/00-verify-latest-patch-workflow.mdmarkdown1.7 KB
workflows/01-run-test-suite-workflow.mdmarkdown12.7 KB
workflows/02-resolve-deprecation-warnings-workflow.mdmarkdown6.3 KB
workflows/03-validate-upgrade-path-workflow.mdmarkdown1.8 KB
workflows/04-setup-next-rails-workflow.mdmarkdown1.5 KB
workflows/05-detect-breaking-changes-workflow.mdmarkdown20.0 KB
workflows/06-check-gem-compatibility-workflow.mdmarkdown11.1 KB
workflows/07-boot-smoke-test-workflow.mdmarkdown7.3 KB
workflows/08-generate-upgrade-report-workflow.mdmarkdown12.7 KB
workflows/09-generate-app-update-preview-workflow.mdmarkdown7.3 KB
workflows/10-implement-and-upgrade-workflow.mdmarkdown2.5 KB
workflows/11-sync-ci-workflow.mdmarkdown8.6 KB
workflows/12-align-load-defaults-workflow.mdmarkdown952 B
workflows/13-mention-cleanup-workflow.mdmarkdown1.3 KB

detection-scripts/patterns/rails-52-patterns.expectations.yml

View on GitHub
# Fixture expectations for rails-52-patterns.yml.
#
# Keyed by variable_name. `match` lines the pattern MUST flag, `no_match`
# lines it MUST NOT flag (a per-line grep + grep -v).
#
# Run with:
#   bin/test-patterns rails-upgrade/detection-scripts/patterns/rails-52-patterns.yml

DYNAMIC_ROUTE_SEGMENTS:
  # A :controller or :action segment inside a quoted route path. Hash keys
  # (controller: 'x', :action => 'y') are options, not segments.
  match:
    - "  get ':controller(/:action(/:id))'"
    - "  match 'admin/:controller/:action', via: :get"
    - "  get 'reports/:action', controller: 'reports'"
    - "  get \"/:controller/:id\""
    - "  get '(:controller)(/:action)'"
  no_match:
    - "  get 'posts', controller: 'posts', action: :index"
    - "  match 'posts' => 'posts#index', :controller => 'posts', :action => 'index'"
    - "  get 'steps/:action_name', to: 'wizard#show'"
    - "  get ':controller_id/show', to: 'a#b'"
    # A hash key right after ( is an option, not a segment
    - "  scope(:controller => 'admin') do"
    - "  constraints(:action => /show/) do"

CLASS_NAME_CONSTANT:
  # A constant passed to class_name raises ArgumentError in 5.2. A string,
  # or Foo.name / Foo.to_s, is fine.
  match:
    - "  belongs_to :owner, class_name: User"
    - "  has_many :items, class_name: Billing::Item, foreign_key: :order_id"
    - "  has_many :items, :class_name => Item"
  no_match:
    - "  belongs_to :owner, class_name: 'User'"
    - "  belongs_to :owner, class_name: \"User\""
    - "  belongs_to :owner, class_name: User.name"
    - "  has_many :items, class_name: Billing::Item.to_s"
    - "  has_many :items, :class_name => 'Item'"

ERROR_ON_IGNORED_ORDER_OR_LIMIT:
  match:
    - "  config.active_record.error_on_ignored_order_or_limit = true"
  no_match:
    - "  config.active_record.error_on_ignored_order = true"

HALT_CALLBACK_CHAINS_ON_RETURN_FALSE:
  match:
    - "ActiveSupport.halt_callback_chains_on_return_false = false"
    - "  config.active_support.halt_callback_chains_on_return_false = false"
  no_match:
    - "  throw :abort"

CALLBACK_STRING_CONDITIONS:
  # A string (or array of strings) passed to if: / unless: raises
  # ArgumentError in 5.2 for every ActiveSupport callback.
  match:
    - "  before_save :normalize, if: 'name_changed?'"
    - "  after_commit :notify, on: :create, unless: \"skip_notify\""
    - "  before_action :authenticate, if: 'request.format.json?'"
    - "  skip_before_action :verify_authenticity_token, :if => 'api_request?'"
    - "  validates :email, presence: true, if: 'active?'"
    - "  validates_presence_of :email, :unless => 'guest?'"
    - "  validate :check_limits, if: ['active?', 'paid?']"
    - "  set_callback :save, :before, :stamp, if: 'stamp?'"
  no_match:
    - "  before_save :normalize, if: :name_changed?"
    - "  before_action :set_format, if: -> { params[:format] == 'json' }"
    - "  validates :email, presence: { message: 'is required' }, if: :active?"
    - "  after_save :sync, if: :sync? # was if: 'sync?'"
    - "  # before_save :normalize, if: 'name_changed?'"

EVENTED_REDIS_ADAPTER:
  match:
    - "  adapter: evented_redis"
    - "ActionCable::SubscriptionAdapter::EventedRedis.em_redis_connector = ->(config) { EM::Hiredis.connect(config[:url]) }"
  no_match:
    - "  adapter: redis"
    - "  channel_prefix: evented_redis_app"

ERUBIS_HANDLER:
  # Only the Rails handler constants; the erubis gem itself is not a Rails change.
  match:
    - "class LegacyHandler < ActionView::Template::Handlers::Erubis"
    - "ActionView::Template::Handlers::ERB.erb_implementation = ActionView::Template::Handlers::ERB::Erubis"
  no_match:
    - "class CustomHandler < ActionView::Template::Handlers::ERB::Erubi"
    - "Erubis::Eruby.new(template).result(binding)"

QUOTED_ID_METHOD:
  match:
    - "  def quoted_id"
    - "  sql = \"owner_id = #{owner.quoted_id}\""
  no_match:
    - "  def quoted_identifier"
    - "  where(owner_id: owner.id)"

CONNECTION_VERIFY_ARGUMENTS:
  # 5.2 defines connection verify! with no parameters.
  match:
    - "  ActiveRecord::Base.connection.verify!(0)"
    - "  ActiveRecord::Base.connection.verify! 5"
  no_match:
    - "  ActiveRecord::Base.connection.verify!"
    - "  ActiveRecord::Base.connection.verify! if defined?(ActiveRecord)"
    - "  cookies.signed.verify(token)"
    - "  expect(conn).to receive(:verify!).with(no_args)"

LOCK_BANG_UNPERSISTED:
  # Every lock! / with_lock call site; the audit decides whether the record
  # has unsaved changes at that point.
  match:
    - "  account.lock!"
    - "  account.lock!(\"FOR UPDATE NOWAIT\")"
    - "    lock!"
    - "  account.with_lock do"
  no_match:
    - "  def lock!(lock = true)"
    - "  account.unlock!"
    - "  Account.lock.find(params[:id])"
    - "  user.locked!"

LEGACY_SECRET_TOKEN:
  match:
    - "Rails.application.config.secret_token = 'a1b2c3'"
    - "  secret_token: <%= ENV['SECRET_TOKEN'] %>"
    - "  Rails.application.secrets.secret_token"
  no_match:
    - "  secret_key_base: <%= ENV['SECRET_KEY_BASE'] %>"
    - "Rails.application.config.secret_key_base = ENV['SECRET_KEY_BASE']"
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall