dhh-rails-reviewer

Review Rails code for convention adherence and anti-patterns.

3|1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/i3ringit/antigravity-cortex --skill dhh-rails-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dhh-rails-reviewer
Source: https://github.com/i3ringit/antigravity-cortex/tree/main/.agent/skills/dhh-rails-reviewer
Command: npx skills add https://github.com/i3ringit/antigravity-cortex --skill dhh-rails-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides brutally honest Rails code review feedback from the perspective of David Heinemeier Hansson, ensuring adherence to Rails conventions and avoiding cross-pollination with JavaScript frameworks.

Core Features & Use Cases

  • Rails-convention adherence audit: ensures skinny controllers, fat models, proper ActiveRecord usage, and RESTful routes.
  • Anti-pattern detection: highlights unnecessary abstractions like overuse of service objects where model methods suffice, or decorators where helpers are more appropriate, and flags non idiomatic Rails patterns.
  • Architecture evaluation: reviews architectural decisions to favor Rails' monolithic, convention-driven approach and warns against premature microservices or GraphQL when REST and Rails patterns suffice.
  • JS-framework contamination detector: identifies JavaScript-centric patterns that erode Rails conventions and proposes Rails-aligned alternatives.
  • Use Case: when reviewing a new Rails feature or refactor to ensure it adheres to Rails philosophy.

Quick Start

Run a focused Rails convention review on the provided codebase and deliver actionable feedback in DHH's voice.

Frequently Asked Questions about dhh-rails-reviewer

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

FAQPage Schema
How do I review Rails code for convention compliance?

Rails code review enforces adherence to Rails conventions by auditing controller skinnyness, model fatness, proper ActiveRecord usage, and RESTful routing patterns. This skill delivers actionable feedback aligned with Rails philosophy to catch anti-patterns and ensure idiomatic Rails architecture.

What anti-patterns should I watch for in Rails projects?

Common Rails anti-patterns include unnecessary service objects where model methods suffice, overuse of decorators instead of helpers, premature microservices, and GraphQL adoption when REST and Rails conventions better fit the problem. This skill flags these deviations and proposes Rails-aligned alternatives.

How do I detect JavaScript framework contamination in Rails code?

JavaScript-centric patterns erode Rails conventions when frontend-driven abstractions override Rails' monolithic, convention-driven approach. This skill identifies those patterns and recommends Rails-native solutions to preserve architectural coherence.

Can I use this for reviewing new Rails features and refactors?

Yes. This skill audits new Rails features and refactors to ensure they adhere to Rails conventions, avoid architectural anti-patterns, and maintain Rails philosophy. It applies to any codebase review where Rails idiomatic usage matters.

What's the difference between Rails conventions and unnecessary abstractions?

Rails conventions favor fat models, skinny controllers, and RESTful routes; unnecessary abstractions like overengineered service objects or decorator layers add complexity without Rails-aligned benefit. This skill distinguishes legitimate patterns from over-abstraction.