skills.rest
dhruvasagar
dhruvasagarCOMMUNITY
Explore all skills by this author →
Website𝕏@dhruvasagarGitHub

Upgrade Audit

Audit Ruby projects for upgrade readiness and generate a findings report.

12|1|Updated Apr 16, 2026
Search Tags:#compatibility#audit#upgrade#ruby#rails#preflight#findings
One-click install
npx skills add https://github.com/dhruvasagar/ruby-upgrade-toolkit --skill upgrade-audit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Upgrade Audit
Source: https://github.com/dhruvasagar/ruby-upgrade-toolkit/tree/main/skills/audit
Command: npx skills add https://github.com/dhruvasagar/ruby-upgrade-toolkit --skill upgrade-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This read-only skill performs a comprehensive pre-upgrade audit to identify compatibility gaps, potential breakages, and scope for Ruby and Rails upgrades.

Core Features & Use Cases

  • Detect current Ruby and Rails versions in the project
  • Compute an upgrade path with intermediate versions
  • Validate target combinations against compatibility references
  • Produce a structured Findings report including preflight checks and risk assessment

Quick Start

Run the audit on your project with the target versions, for example /ruby-upgrade-toolkit:audit ruby:3.0.0 rails:6.1 to generate a read-only findings report

Frequently Asked Questions about Upgrade Audit

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

FAQPage Schema
How do I audit a Ruby on Rails project for upgrade compatibility?▼

A pre-upgrade audit detects current Ruby and Rails versions, computes an upgrade path with intermediate versions, and validates target combinations against compatibility references to identify migration risks.

What is a preflight check for a Ruby version upgrade?▼

A preflight check for a Ruby version upgrade is a read-only assessment that scans your project to compute an upgrade path, validate target combinations, and identify compatibility gaps or gem concerns before migration.

Can I generate an upgrade path for a non-Rails Ruby project?▼

Yes, you can apply the audit to non-Rails Ruby projects by specifying a target like ruby:X.Y.Z to compute intermediate versions, validate compatibility, and generate a structured findings report.

How do I check if my gems are compatible with a target Rails version?▼

You check gem compatibility with a target Rails version by running an audit with rails:X.Y to validate target combinations against compatibility references and surface potential gem concerns.

Does the Ruby upgrade audit modify my project files?▼

No, the Ruby upgrade audit enforces strictly read-only behavior, analyzing your project to produce a findings report and planned upgrade path without modifying any existing files.

Related Skills

Explore More Software Engineering Skills→
fabnfabn
1

rails:test

Generate RSpec tests and FactoryBot factories for Ruby on Rails applications.

Community
Advanced
camoneartcamoneart
5

dependency-upgrade

Coordinate major dependency upgrades with compatibility analysis and staged rollout.

Community
Intermediate
chicanoandres702chicanoandres702

framework-migration-deps-upgrade

Audit npm and Python dependencies and propose safe upgrade targets.

Community
Advanced
R2W1csR2W1cs
1

lint-and-validate

Lint and validate JavaScript and Python code for syntax and style issues.

Community
Intermediate