tech-debt-audit

Audit Ruby and Rails codebases for security, dependency, coverage, and complexity issues.

19|4|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/fastruby/tech-debt-skill --skill tech-debt-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-debt-audit
Source: https://github.com/fastruby/tech-debt-skill/tree/main/.claude/skills/tech-debt-audit
Command: npx skills add https://github.com/fastruby/tech-debt-skill --skill tech-debt-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit assists teams in identifying and reporting technical debt across a codebase, surfacing risk, priorities, and actionable findings to drive fixes.

Core Features & Use Cases

  • Security and dependency scanning: aggregates vulnerability data from Bundler Audit, Brakeman, and related tools to surface critical issues.
  • Quality and maintainability insights: analyzes code complexity, test coverage, and code churn to highlight high-risk areas and suggested refactors.
  • Comprehensive reporting: produces a prioritized, developer-friendly report with actionable recommendations for Ruby on Rails projects.

Quick Start

Run the audit against your project directory to generate a detailed tech debt report.

Frequently Asked Questions about tech-debt-audit

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

FAQPage Schema
How do I audit a Ruby on Rails codebase for technical debt?

The best way to audit technical debt is combining multiple analysis types: security scanning, dependency checking, coverage analysis, and complexity metrics aggregated into one prioritized report, which provides a comprehensive risk overview versus checking isolated metrics.

Does this tech debt audit work with mixed Ruby and JavaScript applications?

Yes, the tech debt audit works with mixed Ruby and JavaScript applications by adapting to common project layouts and configurations to deliver comprehensive security and complexity insights across both environments.

What tools are needed to run a security and dependency audit for Rails?

Running a security and dependency audit for Rails requires tools like bundler-audit, brakeman, and bundler-leak, which surface vulnerability data and dependency risks during the automated technical debt assessment.

Can I measure Ruby code complexity and maintainability during a tech debt audit?

Yes, you can measure Ruby code complexity and maintainability during a tech debt audit using tools like rubycritic and skunk, which analyze code churn and structural complexity to highlight high-risk areas for refactoring.

Does the audit require installing missing scanning tools globally?

Yes, the audit expects to install any missing scanning tools globally to ensure deterministic results across different environments and CI setups during the technical debt analysis.