Menu
Pagination in Rails using will_paginate. Use when adding page navigation to index actions or API endpoints.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create new Rails skills, modify and improve existing ones. Use when the user wants to build a new skill from scratch, improve an existing skill, capture a workflow as a reusable skill, or turn a repeated Rails pattern into a skill. Triggers on: "create a skill", "new skill for", "turn this into a skill", "skill for X", "add a skill", "improve this skill".
Bulk insert, upsert, and update operations in Rails - insert_all, upsert_all, update_all, find_in_batches, and activerecord-import. Use when processing large datasets, imports, or batch writes that would be too slow with individual ActiveRecord saves.
Fan-out scheduler pattern - one orchestrator job dispatches many worker jobs efficiently using perform_all_later and Set-based filtering. Use when processing large external datasets, scheduled syncs, or any operation that reads N records and needs to dispatch N background jobs without blocking.
Queue-level concurrency controls in Solid Queue to respect external API rate limits. Use when a job calls a third-party API with burst or concurrency limits, or when you need to cap how many instances of a job type run in parallel across all workers.
Configures Solid Queue for background jobs in Rails 8. Use when setting up background processing, creating background jobs, configuring job queues, or migrating from Sidekiq to Solid Queue.
Rails error handling - custom exception hierarchy, rescue_from in controllers, consistent API error responses, Sentry integration, and the bridge between dry-monads Failure() and HTTP status codes.
| name | pagination-patterns |
| description | Pagination in Rails using will_paginate. Use when adding page navigation to index actions or API endpoints. |
| allowed-tools | Read, Write, Edit, Bash, Glob, Grep |
# Gemfile
gem "will_paginate"
# Controller
def index
@page = params[:page] || 1
@posts = Post.published.order(created_at: :desc)
.paginate(page: @page, per_page: 25)
end
Works on any ActiveRecord relation — scopes, joins, includes, anything:
@messages = User.role_support.last
.unread_messages
.order(:conversation_id)
.paginate(page: @page, per_page: 25)
<%= render @posts %>
<%= will_paginate @posts %>
def index
@posts = Post.published.order(created_at: :desc)
.paginate(page: params[:page], per_page: 25)
render json: {
posts: PostSerializer.render(@posts),
page: @posts.current_page,
total_pages: @posts.total_pages,
total: @posts.total_entries
}
end
# spec/requests/posts_spec.rb
RSpec.describe "Posts", type: :request do
let!(:posts) { create_list(:post, 30, :published) }
it "renders first page with pagination nav" do
get posts_path
expect(response).to have_http_status(:ok)
# will_paginate renders a <div class="will-paginate"> nav when multiple pages exist
expect(response.body).to include("will-paginate")
# Only 25 of 30 posts on page 1 — last 5 posts appear only on page 2
expect(response.body).not_to include(posts.last.title)
end
it "renders page 2 with remaining records" do
get posts_path, params: { page: 2 }
expect(response).to have_http_status(:ok)
expect(response.body).to include(posts.last.title)
end
end
# For API endpoints — parse JSON response
RSpec.describe "Posts API", type: :request do
before { create_list(:post, 30, :published) }
it "paginates results" do
get posts_path, as: :json
json = response.parsed_body
expect(json["posts"].size).to eq(25)
expect(json["total_pages"]).to eq(2)
expect(json["total"]).to eq(30)
end
end
gem "will_paginate" in Gemfile.paginate(page: params[:page], per_page: N) on the relationwill_paginate @collection in the viewincludes() on the relation to prevent N+1