CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

93

1.78x
Quality

95%

Does it follow best practices?

Impact

93%

1.78x

Average score across 28 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

compatibility_matrix.mdskills/engines/upgrade-engine/assets/

Rails Engine Compatibility Matrix

Purpose: Quick reference mapping of Ruby and Rails versions to supported patterns and required shims.

Supported matrix (example):

  • Rails 7.1, Ruby 3.1+: Preferred - Zeitwerk autoloading, config.load_defaults 7.1
  • Rails 7.0, Ruby 3.0: Supported - ensure zeitwerk-compatible constant names, avoid eager_load hacks
  • Rails 6.1, Ruby 2.7: Legacy - use zeitwerk compatibility flags, add explicit require paths for some initializers
  • Rails 5.2, Ruby 2.5: Deprecated - recommend migration plan, guard features behind version checks

Compatibility actions:

  • Use feature-detection over version checks where possible (respond_to?, defined?)
  • Avoid private API usage that changed between minor Rails versions
  • Provide polyfills only when necessary and gate them by version checks
  • Add CI matrix entries to verify combinations used by clients

Notes: Keep engine code forward-compatible by following public APIs and avoiding assumptions about initialization order. Document any unavoidable host-app contract requirements in README and engine docs.

skills

engines

upgrade-engine

assets

compatibility_matrix.md

zeitwerk_notes.md

EXAMPLES.md

SKILL.md

README.md

tile.json