rails-code-conventions

Enforce Rails code conventions across models, services, controllers, and workers.

22|6|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/igmarin/rails-agent-skills --skill rails-code-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rails-code-conventions
Source: https://github.com/igmarin/rails-agent-skills/tree/main/rails-code-conventions
Command: npx skills add https://github.com/igmarin/rails-agent-skills --skill rails-code-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

An actionable guide to maintainable Rails code by applying core design principles (DRY, YAGNI, PORO, CoC, KISS), per-path rules, structured logging, and disciplined commenting to ensure consistent, high-quality code across models, services, controllers, workers, and repositories.

Core Features & Use Cases

  • Defines a consistent design blueprint for Rails projects, including principles, per-area rules, and logging guidance.
  • Helps teams enforce coding standards during reviews and onboarding, reducing technical debt and improving maintainability.
  • Use Case: When starting a new Rails feature, consult the conventions to structure services, models, and jobs with clear responsibilities and logging practices.

Quick Start

Apply these conventions when starting a Rails codebase audit to ensure DRY, PORO, and clean logging across models, services, controllers, and jobs.

Frequently Asked Questions about rails-code-conventions

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

FAQPage Schema
What are the key Rails code conventions for maintaining clean projects?

Key Rails code conventions involve applying design principles like DRY, YAGNI, PORO, and CoC across models, services, controllers, and workers to ensure maintainable, high-quality code with structured logging.

How do I structure a new Rails feature using services and POROs?

Structure new Rails features by consulting per-path rules to assign clear responsibilities to services, models, and jobs, utilizing Plain Old Ruby Objects (POROs) to keep code clean and maintainable.

Does this Rails convention guide cover RSpec testing patterns?

Yes, this Rails convention guide covers RSpec patterns as part of its targeted use cases, establishing a consistent design blueprint that includes testing strategies to reduce technical debt during code reviews.

Can I use these conventions to enforce coding standards during team onboarding?

Yes, you can use these conventions to enforce coding standards during team onboarding and code reviews, providing a consistent design blueprint that reduces technical debt and improves project maintainability.

What is the best way to implement structured logging in a Rails codebase?

The best way to implement structured logging in a Rails codebase is by following defined logging guidance and per-area rules for models, services, and workers to ensure consistent, high-quality logging practices.

When should I apply YAGNI and KISS principles in Rails development?

Apply YAGNI and KISS principles in Rails development when structuring models, services, controllers, and jobs to enforce disciplined coding, avoid unnecessary complexity, and reduce technical debt across the codebase.