What architectural patterns does this skill implement?

It implements Concerns, Service Objects, Query Objects, Form Objects, and Value Objects to ensure each part of your code has a single responsibility.

When should I use the Rails Model Best Practices skill?

Use this skill when a Rails model grows beyond 100 lines, contains mixed responsibilities, or has become difficult to read and test.

Can I use this for refactoring existing legacy codebases?

Yes, it is specifically designed to analyze existing Ruby files and suggest the most appropriate pattern for extracting complex logic into modern Rails structures.

How does this skill improve my Rails application's testability?

By moving logic from the model into smaller, specialized classes like Service Objects or Query Objects, you can write faster, more focused unit tests for each specific piece of logic.

Does this skill move associations and enums out of the model?

No. According to the decision framework, associations, enums, and core validations are kept within the model file as they are central to the ActiveRecord definition.

Rails Model Refactoring Best Practices

Name: Rails Model Refactoring Best Practices
Author: CodySwannGT

byCodySwannGT

•

Database Management

Refactors bloated Ruby on Rails models into clean, maintainable patterns like Service Objects, Concerns, and Query Objects.

This skill empowers Claude to analyze and refactor Ruby on Rails ActiveRecord models that have become difficult to maintain due to size or complexity. By applying industry-standard architectural patterns—including Concerns for shared logic, Service Objects for business operations, Query Objects for complex database interactions, and Form Objects for context-specific validations—it transforms 'fat models' into slim, single-responsibility components. It provides a structured decision framework to help developers decide exactly where code should reside, ensuring long-term maintainability and cleaner domain logic in Rails applications.

Key Features

01Automated model refactoring using a structured decision framework

02Implementation of Form Objects for complex, context-specific validations

03Encapsulation of advanced ActiveRecord queries into reusable Query Objects

041 GitHub stars

05Organization of shared model capabilities into modular Rails Concerns

06Extraction of complex business logic into standalone Service Objects

Use Cases

01Slimming down ActiveRecord models that exceed 100 lines of code

02Decoupling side-effect-heavy callbacks from the database persistence layer

03Moving complex SQL and multi-join logic out of model scopes into dedicated classes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codyswanngt/lisa active-record-model-best-practices

For use in Claude.ai and ChatGPT

Key Features

01Automated model refactoring using a structured decision framework

02Implementation of Form Objects for complex, context-specific validations

03Encapsulation of advanced ActiveRecord queries into reusable Query Objects

041 GitHub stars

05Organization of shared model capabilities into modular Rails Concerns

06Extraction of complex business logic into standalone Service Objects

Use Cases

01Slimming down ActiveRecord models that exceed 100 lines of code

02Decoupling side-effect-heavy callbacks from the database persistence layer

03Moving complex SQL and multi-join logic out of model scopes into dedicated classes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codyswanngt/lisa active-record-model-best-practices

For use in Claude.ai and ChatGPT