rails-conventions

Identify and explain standard Ruby on Rails 7+ conventions for application structure.

3|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/bastos/ruby-plugin-marketplace --skill rails-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rails-conventions
Source: https://github.com/bastos/ruby-plugin-marketplace/tree/main/plugins/ruby-on-rails/skills/rails-conventions
Command: npx skills add https://github.com/bastos/ruby-plugin-marketplace --skill rails-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Rails conventions help teams build maintainable Rails apps by providing a consistent structure and patterns.

Core Features & Use Cases

  • Canonical file structure map for Rails 7+ apps (app/, config/, lib/), guiding organization and onboarding.
  • Clear naming conventions, RESTful routing, and architectural patterns (fat models, skinny controllers, concerns) to improve maintainability and collaboration.
  • Use Case: when starting or refactoring a Rails project, follow these conventions to ensure scalable, predictable code organization and easier teamwork.

Quick Start

Explain Rails conventions for a new app to structure controllers, models, views, and routing according to the Rails Way.

Frequently Asked Questions about rails-conventions

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

FAQPage Schema
What are the standard Ruby on Rails conventions for structuring an application?

Rails conventions provide a canonical file structure map for Rails 7+ apps, covering app/, config/, and lib/ directories. They establish clear naming patterns, RESTful routing, and architectural guidelines like fat models and skinny controllers to ensure maintainable and predictable code organization.

How do I organize controllers and models using the fat model skinny controller pattern in Rails?

To apply the fat model skinny controller pattern, keep your Rails controllers lean by delegating business logic and data validation to the models. This architectural convention improves maintainability by ensuring controllers primarily handle request routing and responses.

What is the correct way to set up RESTful routing in a Rails 7 application?

Setting up RESTful routing in Rails 7 involves mapping HTTP verbs to controller actions conventionally, ensuring predictable resource endpoints. This standard approach aligns with the Rails Way, guiding scalable application organization and easier collaboration during onboarding and refactoring.

When should I use Rails concerns when refactoring a large application?

Use Rails concerns during refactoring to extract shared logic across multiple models or controllers, adhering to architectural guidelines. This convention prevents code duplication and maintains the fat model, skinny controller balance by grouping related functionalities into modular, reusable modules.

Does this Rails conventions guidance apply to legacy projects or only new apps?

These Rails conventions apply to both new applications and legacy refactoring efforts. The guidelines cover standard file structure, naming, and RESTful routing for Rails 7+ projects, ensuring scalable code organization during onboarding, active development, and code reviews.