igmarin/rails-agent-skills

Curated library of 28 public AI agent skills for Ruby on Rails development. Organized by category: testing, code-quality, engines, infrastructure, api, and context. Covers code review, architecture, security, testing (RSpec), engines, Hotwire, and TDD automation. Shared Ruby skills (YARD docs, DDD, service objects) have moved to ruby-core-skills. Repository agents remain documented in GitHub but are intentionally excluded from the Tessl tile.

1.78x

Quality

95%

Does it follow best practices?

Impact

93%

1.78x

Average score across 28 eval scenarios

Securityby

Passed

No known issues

Rails Engine Compatibility — Examples

Name: igmarin/rails-agent-skills
Rating: 93.21 (1 reviews)
Author: igmarin

Gemspec Version Bounds

# Good: narrow and tested
spec.add_dependency "rails", ">= 7.0", "< 8.0"
spec.required_ruby_version = ">= 3.0"

# Bad: claims support without CI evidence
# spec.add_dependency "rails", ">= 5.2"  # untested on 5.2/6.x

Zeitwerk: File and Constant Must Match

# File: lib/my_engine/widget_policy.rb

# ✅ Good: constant matches path
module MyEngine
  class WidgetPolicy
  end
end

# ❌ Bad: will break with Zeitwerk
# class WidgetPolicy  # expected in widget_policy.rb at root — wrong namespace

Run bundle exec rake zeitwerk:check to detect mismatches before shipping.

Reload-Safe Hook

# In engine.rb
initializer "my_engine.setup" do
  config.to_prepare do
    MyEngine::Decorator.apply  # runs on each reload in development
  end
end

Hooks registered outside config.to_prepare run only once at boot and will not pick up reloaded code.

CI Matrix (GitHub Actions)

# .github/workflows/ci.yml
strategy:
  matrix:
    ruby: ["3.1", "3.2", "3.3"]
    rails: ["7.0", "7.1", "7.2"]
steps:
  - name: Set Rails version
    run: bundle config set --local gemfile gemfiles/rails_${{ matrix.rails }}.gemfile
  - run: bundle exec rake zeitwerk:check
  - run: bundle exec rspec

Each claimed version in add_dependency must have a matching row in the matrix.

Optional Integration Matrix

Include this in upgrade reports so compatibility checks cover more than gemspec and Zeitwerk.

Integration	Status	File path checked	Per-version verification
Jobs	present/absent	`app/jobs/my_engine/...`	`bundle exec rspec spec/jobs` across matrix
Mailers	present/absent	`app/mailers/my_engine/...`	`bundle exec rspec spec/mailers` across matrix
Assets	present/absent	`app/assets`, `app/javascript`, `app/views`	dummy app boot + asset build/importmap check
Routes	present/absent	`config/routes.rb`, `spec/dummy/config/routes.rb`	request specs against mounted dummy app
Install generators	present/absent	`lib/generators/my_engine/install_generator.rb`	run generator twice in dummy app; verify idempotence
Dummy app mount	present/absent	`spec/dummy/config/routes.rb`	`bundle exec rspec spec/requests` on each Rails version

agents

docs

evals

skills

api

context

infrastructure

testing

README.md

tile.json