Skip to content
Mick Zijdel

Rails Toolkit

Agent skills encoding Ruby on Rails 8 conventions, so AI-written Rails code follows the framework instead of fighting it

AI agents write Rails code the way the average of the internet writes Rails code — which is to say, fighting the framework. Rails Toolkit is a set of Claude Code skills that encode modern Rails 8 conventions and hard-won project rules, so agent-written code comes out idiomatic: thin controllers, concern-based models, Solid Queue jobs, Stimulus controllers with modern JavaScript, Hotwire/Turbo patterns, fixture-based tests.

It also includes higher-level workflows: a full application audit that orchestrates the individual skills into a severity-ranked health report for inherited codebases, a database performance review, and an upgrade analyzer covering breaking changes from Rails 2.3 through 8.1.

I maintain Rails applications (including the administration system behind a 100-year-old theatre company), and this toolkit is how I make AI agents productive on them without sacrificing code quality.