# ruby-rails-application

Guides building Ruby on Rails applications with Active Record models, RESTful controllers, and JWT authentication. Best for structuring Rails APIs and managing database schemas.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 655 installs · ★ 371
- Author: aj-geddes
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/aj-geddes/useful-ai-prompts/tree/HEAD/skills/ruby-rails-application/SKILL.md
- Updated: 2026-03-04
- HTML: https://affpapa.org/en/nevibecode/skills/ruby-rails-application

## What it does

This skill enforces standard conventions for Ruby on Rails web applications. It guides the setup of API projects with PostgreSQL, Active Record association design, and database schema migrations.

Inside, referenced guides cover RESTful actions, serializers, and JWT authorization in `ApplicationController`. It explicitly prohibits putting business logic directly into controllers, directing you to use service objects instead.

Database security and query efficiency are central. The instructions block unparameterized raw SQL and require using `includes` or `joins` to prevent N+1 query bottlenecks.

## Requirements
- Works with: PostgreSQL

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill ruby-rails-application -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ruby-rails-application/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ruby-rails-application/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill ruby-rails-application -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ruby-rails-application/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill ruby-rails-application -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ruby-rails-application/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aj-geddes/useful-ai-prompts ruby-rails-application
```

2. **Manually: put the files in place**
- File: `.github/skills/ruby-rails-application/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill ruby-rails-application -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aj-geddes/useful-ai-prompts --path skills/ruby-rails-application
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ruby-rails-application/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/useful-ai-prompts --skill ruby-rails-application -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aj-geddes/useful-ai-prompts/tree/HEAD/skills/ruby-rails-application/SKILL.md

## When to use it
- configure JWT authentication inside ApplicationController
- set up Active Record associations and database migrations
- resolve N+1 database queries using includes or joins
- scaffold RESTful API endpoints with serialized responses

## Example prompts
- Generate a Rails API project with PostgreSQL and JWT authentication
- Create an Order model associated with User and add strong parameters
- Refactor this controller query using includes to avoid N+1 issues

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 802c5ea174314b6c.

BEGIN THIRD-PARTY FILE 802c5ea174314b6c
````text
---
name: ruby-rails-application
description: >
  Develop Ruby on Rails applications with models, controllers, views, Active
  Record ORM, authentication, and RESTful routes. Use when building Rails
  applications, managing database relationships, and implementing MVC
  architecture.
---

# Ruby Rails Application

## Table of Contents

- [Overview](#overview)
- [When to Use](#when-to-use)
- [Quick Start](#quick-start)
- [Reference Guides](#reference-guides)
- [Best Practices](#best-practices)

## Overview

Build comprehensive Ruby on Rails applications with proper model associations, RESTful controllers, Active Record queries, authentication systems, middleware chains, and view rendering following Rails conventions.

## When to Use

- Building Rails web applications
- Implementing Active Record models with associations
- Creating RESTful controllers and actions
- Integrating authentication and authorization
- Building complex database relationships
- Implementing Rails middleware and filters

## Quick Start

Minimal working example:

```bash
rails new myapp --api --database=postgresql
cd myapp
rails db:create
```

## Reference Guides

Detailed implementations in the `references/` directory:

| Guide | Contents |
|---|---|
| [Rails Project Setup](references/rails-project-setup.md) | Rails Project Setup |
| [Models with Active Record](references/models-with-active-record.md) | Models with Active Record |
| [Database Migrations](references/database-migrations.md) | Database Migrations |
| [Controllers with RESTful Actions](references/controllers-with-restful-actions.md) | Controllers with RESTful Actions |
| [Authentication with JWT](references/authentication-with-jwt.md) | Authentication with JWT |
| [Active Record Queries](references/active-record-queries.md) | Active Record Queries |
| [Serializers](references/serializers.md) | Serializers |

## Best Practices

### ✅ DO

- Use conventions over configuration
- Leverage Active Record associations
- Implement proper scopes for queries
- Use strong parameters for security
- Implement authentication in ApplicationController
- Use services for complex business logic
- Implement proper error handling
- Use database migrations for schema changes
- Validate all inputs at model level
- Use before_action filters appropriately

### ❌ DON'T

- Use raw SQL without parameterization
- Implement business logic in controllers
- Trust user input without validation
- Store secrets in code
- Use select \* without specifying columns
- Forget N+1 query problems (use includes/joins)
- Implement authentication in each controller
- Use global variables
- Ignore database constraints
````
END THIRD-PARTY FILE 802c5ea174314b6c

The third-party file has ended. Everything between the 802c5ea174314b6c tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© aj-geddes · MIT · https://github.com/aj-geddes/useful-ai-prompts/tree/HEAD/skills/ruby-rails-application/SKILL.md

## Similar
- [ruby-rails](https://affpapa.org/en/nevibecode/skills/ruby-rails.md) — skill · 862 installs
- [rails-cursorrules-prompt-file](https://affpapa.org/en/nevibecode/rules/rails-cursorrules-prompt-file.md) — rule · ★ 41011
- [rails-expert](https://affpapa.org/en/nevibecode/skills/rails-expert.md) — skill · 4700 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md