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.

1.20x

Quality

98%

Does it follow best practices?

Impact

95%

1.20x

Average score across 35 eval scenarios

Securityby

Passed

No known issues

Module README Template

Name: igmarin/rails-agent-skills
Rating: 95.37 (1 reviews)
Author: igmarin

Every service module under app/services/<module_name>/ MUST ship a README.md using this shape. One section per service in the module — even single-service modules get a README.

# <ModuleName> Services

Brief paragraph: what business capability this module covers.

## <ServiceName>

**Purpose:** one-line summary.

**Inputs:** `params [Hash]` with `:key1`, `:key2`, ...

**Success:** `{ success: true, response: { <domain_key>: <value> } }`

**Failure:** `{ success: false, response: { error: { message: String } } }`

**Raises:** `SomeError` when ..., `OtherError` when ... (internally rescued unless noted).

Notes

Keep response shapes consistent with the MANDATORY Response Contract in SKILL.md.
List exception classes even when rescued internally — readers need the full surface.
For class-only services (Pattern 3, e.g. validators), document the actual return type (nil / error string) instead of the success/failure hash if that's what the class returns.