dhruvasagar

dhruvasagar/ruby-upgrade-toolkit

Plugin Claude Code

Plugin marketplace listing 1 plugin: ruby-upgrade-toolkit.

dhruvasagar/ruby-upgrade-toolkit

Plugin Claude Code

Upgrade Ruby and Rails safely: audit breaking changes, plan a phased roadmap, fix code and dependencies, verify with RSpec and RuboCop.

dhruvasagar/ruby-upgrade-toolkit

Agent

Use this agent when the user asks to fix deprecation warnings in a specific file, wants to batch-fix all deprecations in a directory, or asks to clear all deprecation warnings from the test suite. This agent autonomously fixes safe deprecation patterns and guides the user through complex ones. Examples.

dhruvasagar/ruby-upgrade-toolkit

Agent

Use this agent when a user describes an upgrade intent in natural language — e.g. "I need to upgrade Ruby to 3.3", "upgrade this app from Rails 7 to 8", "what would it take to get to Ruby 3.2?", "how bad is our deprecation situation?", "audit my app before upgrading", "we're thinking about upgrading", "our app is on…

dhruvasagar/ruby-upgrade-toolkit

Command

Read-only pre-upgrade audit. Surfaces all breaking changes, gem incompatibilities, and deprecations before touching any code. Usage: /ruby-upgrade-toolkit:audit ruby:X.Y.Z [rails:X.Y].

dhruvasagar/ruby-upgrade-toolkit

Command

Apply all upgrade fixes — version pins, gem updates, code changes, RSpec fixes, and RuboCop fixes. Usage: /ruby-upgrade-toolkit:fix ruby:X.Y.Z [rails:X.Y] [scope:path].

dhruvasagar/ruby-upgrade-toolkit

Command

Generate a phased Ruby (and optionally Rails) upgrade roadmap for this project. Detects current versions automatically. Usage: /ruby-upgrade-toolkit:plan ruby:X.Y.Z [rails:X.Y].

dhruvasagar/ruby-upgrade-toolkit

Command

Manage project-specific custom upgrade rules — gem pins, gem swaps, private-source substitutions (Rails LTS, Sidekiq Pro), verification gates (Brakeman, Reek), policy overrides, and more. Subcommands: init, validate, list, show, add, remove, disable, enable, explain.

dhruvasagar/ruby-upgrade-toolkit

Command

Show the current upgrade health dashboard — versions, test suite pass/fail, deprecation count, and overall RED/YELLOW/GREEN readiness. No arguments required.

dhruvasagar/ruby-upgrade-toolkit

Command

Full automated Ruby/Rails upgrade pipeline — audit, phased fixes, and verification with a live task list. Pauses on failure so you can investigate before continuing. Usage: /ruby-upgrade-toolkit:upgrade ruby:X.Y.Z [rails:X.Y].

dhruvasagar/ruby-upgrade-toolkit

Hook

Runs before the agent uses a tool for Write and Edit tool calls, executing block-vendor.sh via bash. From dhruvasagar/ruby-upgrade-toolkit.

dhruvasagar/ruby-upgrade-toolkit

Hook

Runs after a tool call finishes for Write, Edit, Write and Edit tool calls, executing ruby-version-sync.sh and rubocop-fix.sh via bash (2 commands). From dhruvasagar/ruby-upgrade-toolkit.

dhruvasagar/ruby-upgrade-toolkit

Skill Claude CodeCodex

Use when the user runs /ruby-upgrade-toolkit:audit or asks to audit their project before an upgrade, find what will break, check gem compatibility, or assess the scope of an upgrade. Read-only — never modifies files. Accepts ruby:X.Y.Z and optional rails:X.Y arguments.

dhruvasagar/ruby-upgrade-toolkit

Skill Claude CodeCodex

Use when the user runs /ruby-upgrade-toolkit:fix or asks to apply upgrade fixes, bump Ruby/Rails versions, fix deprecations, fix RSpec failures after upgrading, or fix RuboCop issues. Accepts next (read target from the task list) OR explicit ruby:X.Y.Z, optional rails:X.Y, and optional scope:path arguments. Applies…

dhruvasagar/ruby-upgrade-toolkit

Skill Claude CodeCodex

Use when the user runs /ruby-upgrade-toolkit:plan or asks to plan a Ruby or Rails upgrade, generate an upgrade roadmap, or understand what phases are involved in bumping versions. Accepts ruby:X.Y.Z and optional rails:X.Y arguments. Produces a phased, project-specific upgrade plan with estimates AND creates a…

dhruvasagar/ruby-upgrade-toolkit

Skill Claude CodeCodex

Internal reference skill loaded by audit and fix skills for version-specific Rails breaking changes and fix patterns. Not a user-facing skill — do not activate this directly. Only load it when explicitly referenced by another skill in this plugin.

dhruvasagar/ruby-upgrade-toolkit

Skill Claude CodeCodex

Use when the user runs /ruby-upgrade-toolkit:rules or asks to add, list, validate, show, remove, disable, enable, or explain project-specific upgrade rules — gem pins, gem swaps, private-source substitutions (Rails LTS, Sidekiq Pro), verification gates (Brakeman, Reek), policy overrides. Reads and writes…

dhruvasagar/ruby-upgrade-toolkit

Skill Claude CodeCodex

Use when the user runs /ruby-upgrade-toolkit:status or asks for the current upgrade status, upgrade progress report, whether the upgrade is complete, or a summary of what's done and what's remaining. No arguments — detects everything from the project state. Produces a RED/YELLOW/GREEN health report.

dhruvasagar/ruby-upgrade-toolkit

Skill Claude CodeCodex

Use when the user runs /ruby-upgrade-toolkit:upgrade or wants a fully automated Ruby/Rails upgrade pipeline. Orchestrates a phased upgrade by delegating per-phase execution to the fix skill and verification to the status skill. Keeps a live task list, pauses on RED verification, and lets the user continue, retry, or…