CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/rails-agent-skills

Curated library of 39 AI agent skills for Ruby on Rails development. Organized by category: planning, testing, code-quality, ddd, engines, infrastructure, api, patterns, context, orchestration, and workflows. Includes 5 callable workflow skills (rails-tdd-loop, rails-review-flow, rails-setup-flow, rails-quality-flow, rails-engines-flow) for complete development cycles. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and TDD automation.

95

1.20x
Quality

98%

Does it follow best practices?

Impact

95%

1.20x

Average score across 35 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

EXAMPLES.mdskills/engines/rails-engine-compatibility/

Rails Engine Compatibility — Examples

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.

skills

engines

rails-engine-compatibility

EXAMPLES.md

SKILL.md

README.md

tile.json