skills.rest
reckerswartz
reckerswartzCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

mailer-agent

Scaffold Rails ActionMailer classes with HTML/text templates, previews, and RSpec tests.

Updated Mar 19, 2026
Search Tags:#testing#templates#mailer#rails#previews#actionmailer
One-click install
npx skills add https://github.com/reckerswartz/resume_builder --skill mailer-agent-reckerswartz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mailer-agent
Source: https://github.com/reckerswartz/resume_builder/tree/main/.windsurf/skills/mailer-agent
Command: npx skills add https://github.com/reckerswartz/resume_builder --skill mailer-agent-reckerswartz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Rails developers often build and maintain transactional emails by hand, duplicating boilerplate for mailers, templates, previews, and tests, leading to inconsistent quality and missing development previews.

Core Features & Use Cases

  • Create ActionMailer classes with HTML and text templates
  • Generate RSpec tests and development previews for each mailer
  • Align with Rails conventions and Solid Queue for background delivery
  • Support common use cases like notifications, password resets, and alerts
  • Provide guidance on configuration, I18n, and delivery workflows

Quick Start

Create a new mailer, add HTML and text templates, write previews and spec tests, then run rspec to verify delivery.

Frequently Asked Questions about mailer-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold Rails ActionMailer classes with previews and tests?▼

Scaffolding Rails ActionMailer classes involves generating mailer files alongside HTML and text templates, RSpec tests, and development previews. This ensures transactional emails like password resets and notifications include both template formats and test coverage from the start.

What is the best way to organize Rails mailers, previews, and templates?▼

Organizing Rails mailers requires placing classes in app/mailers, views in app/views, and specs in spec/mailers. Following these conventions ensures ActionMailer previews and RSpec tests function correctly while keeping I18n and delivery workflows properly structured.

Does ActionMailer work with Solid Queue for background email delivery in Rails 8?▼

ActionMailer works with Solid Queue for background email delivery in Rails 8 apps. Configuring Solid Queue handles asynchronous sending of transactional emails, while development mailer previews and RSpec tests verify content and delivery logic before production use.

Can I generate both HTML and text email templates for Rails mailers automatically?▼

Generating both HTML and text email templates for Rails mailers ensures multi-format transactional emails. Scaffolding tools can automatically create both template types alongside ActionMailer classes, enforcing consistency and preventing missing text alternatives for email clients.

Why do my Rails mailer previews show missing templates or fail RSpec tests?▼

Rails mailer previews fail when HTML or text templates are missing from app/views or when spec/mailers lacks corresponding RSpec tests. Scaffolding mailers with both templates and previews simultaneously prevents these gaps and ensures ActionMailer preview functionality.

Do I need RSpec to test ActionMailer mailers in Rails 8?▼

RSpec is required to test ActionMailer mailers in Rails 8 within this workflow. Generating spec tests alongside mailer classes and previews ensures transactional emails like alerts and notifications have verified delivery logic and template rendering before deployment.

Related Skills

Explore More Software Engineering Skills→
reckerswartzreckerswartz

mailer

Automate ActionMailer email creation and testing with RSpec and Solid Queue.

Community
Advanced
mlbrightmlbright

mailer-agent

Generate Action Mailer classes, RSpec tests, and email templates for Rails applications.

Community
Intermediate
reckerswartzreckerswartz

job

Create and test idempotent background jobs in Rails with Solid Queue.

Community
Advanced
pelletencatepelletencate

mailers

Automate ActionMailer email delivery and testing with SolidQueue async jobs.

Community
Intermediate