Layered Rails Skills plugin
Keep Rails layers in check: god objects, callbacks, services and CI layer boundaries, following the Layered Design book.
- 479 ★ on the repository
- Last commit
Extended access
Why this level
- The commands read project code and `archspec` creates a file in the repository.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/layered-rails-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The commands read project code and `archspec` creates a file in the repository.
This is third-party code. Review the repository files before installing.
What it does
The plugin follows the book Layered Design for Ruby on Rails Applications. The `layered-rails` skill, with workflows, references and examples, tells an agent which layer of a Rails app a piece of code belongs in and what should be extracted from models and controllers. It ships the commands `/layered-rails:analyze`, `analyze-services`, `analyze-callbacks`, `analyze-gods`, `review`, `spec-test`, `plan` and `archspec`, plus two sub-agents: a planner and a reviewer. `archspec` generates an `Archspec.rb` file that keeps layer boundaries enforced in CI.
Who it is for. Rails developers whose app has outgrown its structure and whose callbacks, services and god objects drag the architecture down.
Good fit when
- A model has grown callbacks and it is unclear which ones belong in a service.
- The `app/services/` directory has sprawled and needs a check for consistent conventions.
- Before merging a branch you want a check for layer boundary violations.
- A team prepares a staged plan for moving to a layered architecture.
Not a fit when
- The project is not built on Rails.
- The app is small and splitting it into layers is premature.
- The architecture already follows a different set of team conventions.
Example request
Run `/layered-rails:analyze-callbacks` on the order models and name three callbacks best extracted into services.Limitations
The rules come from a single book, so the advice reflects its take on layers and may clash with a team's own style. Slash commands and sub-agents work only when the plugin is installed in Claude Code; `npx skills add` delivers the skill alone without commands. Per-gem references such as Action Policy and ViewComponent install only through rails-hyperdrive when the gem is in `Gemfile.lock`. `Archspec.rb` changes the project, so read it before committing. The last repository commit is from September 2026.
How to disable. Run `/plugin uninstall layered-rails@layered-rails-skills` and remove the marketplace. Delete a generated `Archspec.rb` from the project by hand.
FAQ
How does the plugin differ from a skills.sh install?
The plugin brings the skill, slash commands and two sub-agents. `npx skills add` delivers the skill only, though every workflow can still be requested in plain language.
What does `/layered-rails:spec-test` do?
It applies the specification test to chosen files and shows which layer the code belongs in.
What does `/layered-rails:archspec` create?
An `Archspec.rb` file with layer boundaries, checked in CI.
Does the skill work with Codex?
Yes, the core content (`SKILL.md`, workflows, references and examples) is usable from Codex too.
Which sub-agents ship with the plugin?
Two: the `layered-rails-planner` planner and the `layered-rails-reviewer` reviewer. Both can be added to the compound-engineering plugin agent list.
Discussion
No questions or reviews yet.
Related
PluginsA skill plugin that builds Rust web apps by Rails conventions, from the skeleton and resources to checks and deployment.
The RubyLLM skill and plugin help an agent write chats, tools, MCP and structured output in Ruby and Rails applications
Laravel API Architecture Skill
Laravel API Production-Ready Architecture Skill
A skill that keeps an agent within a layered Laravel API architecture: JSON:API v1.1, strict types, PHPStan level 8 and tests
A set of 14 skills for Java Spring Boot, from requirements analysis and code generation to tests, review and Docker deployment.
37signals Rails Skills
37signals-skills
Unofficial skills and a guide to writing Rails the 37signals way, from open code of Fizzy, Campfire and over 100 DHH code reviews. Not affiliated with 37signals
Six skills that teach an agent to write Streamling plugins in Rust: sources, sinks, transforms and SQL functions.
README in short
The README covers three install routes, a command table and wiring with the compound-engineering plugin.