rails-engine-compatibility
Installation
SKILL.md
Rails Engine Compatibility
Use this skill when the task is to make an engine stable across framework versions and host environments.
Compatibility work should reduce surprises for host applications. Prefer explicit support targets over accidental compatibility.
Quick Reference
| Compatibility Aspect | Check |
|---|---|
| Zeitwerk | File paths match constant names; no anonymous or root-level constants |
| Gemspec bounds | add_dependency and required_ruby_version match tested versions |
| Feature detection | Use respond_to?, defined?, or adapter seams instead of Rails.version |
| Test matrix | CI runs against each claimed Rails/Ruby combination |
Common Mistakes
| Mistake | Reality |
|---|---|
| Hardcoding Rails version checks | Use feature detection or adapter seams; version branching is brittle and often wrong |
Related skills