thoughtbot-dev

Perform comprehensive code audits of Ruby on Rails applications based on thoughtbot best practices. Use this skill when the user requests a code audit, code review, quality assessment, or analysis of a Rails application. The skill analyzes the entire codebase focusing on testing practices (RSpec), security vulnerabilities, code design (skinny controllers, domain models, PORO with ActiveModel), Rails conventions, database optimization, and Ruby best practices. Outputs a detailed markdown audit report grouped by category (Testing, Security, Models, Controllers, Code Design, Views) with severity levels (Critical, High, Medium, Low) within each category.

Use when refactoring code or when asked to refactor. Provides a 6-gate decision framework to determine whether refactoring is appropriate and when to stop.

Use when writing or reviewing tests in a Ruby/Rails application. Guides agents to write well-structured tests using the Arrange/Act/Assert pattern, semantic Capybara selectors, and performance-aware practices.

Use when encountering bugs, test failures, or unexpected behavior. Provides a systematic debugging process based on surfacing assumptions, building decision tables, and validating one assumption at a time.

Use when writing or modifying code in a Rails application. Guides agents to follow thoughtbot best practices for N+1 prevention, view layer organization, and domain modeling.