form-agent

Create and update multiple Rails models through a single form object.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/reckerswartz/resume_builder --skill form-agent-reckerswartz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: form-agent
Source: https://github.com/reckerswartz/resume_builder/tree/main/.windsurf/skills/form-agent
Command: npx skills add https://github.com/reckerswartz/resume_builder --skill form-agent-reckerswartz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Encapsulates complex multi-model form logic into reusable form objects, eliminating scattered validations and ad-hoc persistence across models.

Core Features & Use Cases

  • Centralized validations and cross-model constraints across multiple ActiveRecord models
  • Nested attributes and virtual attributes support with clear persistence boundaries
  • Rails 8 + ActiveModel integration with Turbo-friendly responses for inline errors
  • Ideal for registrations, multi-step wizards, and forms that span several models

Quick Start

Create a new form object to orchestrate a multi-model update in your Rails application.

Frequently Asked Questions about form-agent

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

FAQPage Schema
How do I handle multiple model creation and validation in a single Rails form?

Multi-model Rails forms use a form object to unify creation and update logic, coordinating validations and persistence across several ActiveRecord models in a single transaction.

What is the best way to build multi-step wizards with nested attributes in Rails?

Multi-step wizards benefit from form objects that support nested and virtual attributes, enforcing centralized validations while integrating with Rails controllers and Turbo-enabled views for inline error handling.

Does this form object approach work with Rails 8 and Turbo for inline errors?

Yes, the form object integrates with Rails 8 and ActiveModel, returning Turbo-friendly responses that render inline validation errors directly in your views without full page reloads.

Can I use ActiveModel validations for cross-model constraints in complex search forms?

Yes, ActiveModel form objects centralize cross-model constraints and validations, making them ideal for complex search forms or registrations where multiple models require coordinated validation.

When should I use form objects instead of standard ActiveRecord nested attributes?

Use form objects when you need to eliminate scattered validations and ad-hoc persistence across models, encapsulating complex multi-model logic into a single reusable coordination layer.

Why do my multi-model forms fail to persist atomically during user registrations?

Multi-model forms fail atomically when persistence is not wrapped in a single transaction, a problem solved by using a form object to coordinate validation and save operations together.