ruby

name	ruby
description	This skill should be used when writing or reviewing Ruby code, or when the project uses "Ruby", "RSpec", "service objects", "Struct", "Data class", or Ruby class/module patterns. Provides Ruby coding conventions, patterns, and best practices. Project-specific conventions always take priority.
version	0.1.0

Ruby Conventions

Coding conventions and best practices for Ruby projects. Project-specific conventions (CLAUDE.md, style guides) always take priority over this guidance.

File Structure

• Explicit require statements at top of file

Naming

• Class names in PascalCase, method names in snake_case
• File paths matching class hierarchy (e.g., lib/my_app/user_service.rb for MyApp::UserService)
• Constants in SCREAMING_SNAKE_CASE

Architecture & Design

• Service objects: Command/service pattern for encapsulating business logic outside models
• Module structure: Namespace hierarchy; include for instance behavior, extend for class behavior
• Data structures: Struct or Data classes for value objects instead of raw hashes

Methods

• Keyword arguments for methods with multiple parameters
• def self.method_name for class methods
• Guard clauses for early returns on precondition checks
• attr_reader over direct instance variable access