rails-audit

Audit Ruby on Rails applications for code quality, security, testing, architecture, and performance issues.

7|1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/jcuervo/rails-audit-claude-skill --skill rails-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rails-audit
Source: https://github.com/jcuervo/rails-audit-claude-skill/tree/main
Command: npx skills add https://github.com/jcuervo/rails-audit-claude-skill --skill rails-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a repeatable, end-to-end audit workflow that finds coding standard violations, test coverage gaps, security vulnerabilities, architectural issues, and performance bottlenecks in Ruby on Rails codebases so teams can prioritize actionable fixes.

Core Features & Use Cases

  • Coding Standards: Scans Ruby and Rails code for style violations and anti-patterns based on community guides.
  • Testing & Coverage: Detects test framework, analyzes coverage artifacts, and highlights untested areas.
  • Security Assessment: Searches for OWASP Top 10 issues, exposed secrets, and checks for Brakeman/bundler-audit integration.
  • Architecture & Performance: Identifies N+1 queries, missing indexes, service/query object usage, and provides prioritized recommendations.
  • Report Generation: Produces a presentation-style markdown deck and optionally converts it to PDF for sharing.

Quick Start

Run the audit by typing /rails-audit in Claude Code to scan the repository and generate a markdown report and PDF when available.

Frequently Asked Questions about rails-audit

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

FAQPage Schema
How do I audit a Ruby on Rails application for security and performance issues?

You can perform a comprehensive Rails application audit to identify code quality, security, and performance issues by scanning the app, config, and db directories to produce a prioritized markdown report with actionable fixes.

What does a Rails code audit typically include?

A Rails code audit includes scanning Ruby code for style violations and anti-patterns, detecting test coverage gaps, assessing security vulnerabilities, and identifying performance bottlenecks to produce a presentation-style markdown report.

How do I check my Rails codebase for untested areas and test coverage gaps?

To check for untested areas and test coverage gaps in your Rails codebase, run an audit that detects the test framework, analyzes coverage artifacts, and highlights untested areas to ensure pre-deployment readiness.

Can I generate a PDF report from a Ruby on Rails technical debt assessment?

Yes, you can generate a PDF report from a Rails technical debt assessment by running an audit that produces a presentation-style markdown deck and optionally converts it to PDF for easy sharing.

Does the Rails audit work with Brakeman and bundler-audit checks?

Yes, the Rails audit supports Brakeman and bundler-audit style checks by reading Gemfile and Gemfile.lock, searching for exposed secrets, and identifying OWASP Top 10 security issues during the repository scan.

When should I run a pre-deployment audit on my Rails application?

You should run a pre-deployment audit on your Rails application to identify technical debt, coding standard violations, and security vulnerabilities before release, ensuring the app, config, db, and test directories are clean.