Individual skill

rails-testing

Ruby on Rails testing best practices for writing effective, maintainable test suites with RSpec. This skill should be used when writing, reviewing, or refactoring Rails tests to ensure proper test design, data management, and coverage patterns. Triggers on tasks involving RSpec specs, model tests, request specs, system tests, factory definitions, Capybara interactions, Sidekiq job tests, or test suite optimization. Complementary to rails-dev, ruby-optimise, and ruby-refactor skills.

skills/.curated/rails-testing/SKILL.md

Read pinned source

Source commit cf93c57cac89d6fc3e4194686000411567f5caf3

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Not checked yet
Last checked: Nov 5, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 222
Repository last updated: Aug 15, 2026
License: MIT

Observed agent integration: codex

testing Derived category
engineering Derived category
design Derived category
writing Derived category
data Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

AGENTS.mddoc · 204 bytes
SKILL.mdcore · 8,510 bytes
assets/templates/_template.mddoc · 625 bytes
metadata.jsonasset · 1,291 bytes
references/_sections.mddoc · 2,379 bytes
references/async-separate-enqueue-from-perform.mddoc · 2,946 bytes
references/async-test-after-commit.mddoc · 2,978 bytes
references/async-test-job-perform.mddoc · 2,331 bytes
references/async-test-mailer-delivery.mddoc · 3,115 bytes
references/async-use-fake-mode-default.mddoc · 2,705 bytes
references/data-avoid-fixture-coupling.mddoc · 2,851 bytes
references/data-build-over-create.mddoc · 2,807 bytes
references/data-factory-traits.mddoc · 2,265 bytes
references/data-minimal-attributes.mddoc · 2,111 bytes
references/data-sequence-unique-values.mddoc · 2,282 bytes
references/data-transient-attributes.mddoc · 2,768 bytes
references/design-avoid-conditional-logic.mddoc · 2,310 bytes
references/design-avoid-mystery-guest.mddoc · 2,512 bytes
references/design-behavior-over-implementation.mddoc · 2,520 bytes
references/design-descriptive-test-names.mddoc · 2,361 bytes
references/design-explicit-subject.mddoc · 2,406 bytes
references/design-four-phase-test.mddoc · 2,625 bytes
references/design-one-assertion-per-test.mddoc · 2,794 bytes
references/model-avoid-testing-framework.mddoc · 2,994 bytes
references/model-test-associations.mddoc · 2,346 bytes
references/model-test-callbacks-sparingly.mddoc · 2,766 bytes
references/model-test-custom-methods.mddoc · 3,505 bytes
references/model-test-enums.mddoc · 3,433 bytes
references/model-test-scopes.mddoc · 2,753 bytes
references/model-test-validations.mddoc · 2,857 bytes
references/org-avoid-deep-nesting.mddoc · 3,304 bytes
references/org-custom-matchers.mddoc · 3,789 bytes
references/org-file-structure-mirrors-app.mddoc · 3,320 bytes
references/org-shared-examples-sparingly.mddoc · 3,650 bytes
references/perf-avoid-before-all-mutation.mddoc · 3,048 bytes
references/perf-database-strategy.mddoc · 2,167 bytes
references/perf-parallel-tests.mddoc · 2,135 bytes
references/perf-profile-slow-specs.mddoc · 3,270 bytes
references/perf-quarantine-flaky-tests.mddoc · 2,716 bytes
references/request-json-response-structure.mddoc · 4,070 bytes
references/request-over-controller-specs.mddoc · 2,379 bytes
references/request-test-authentication.mddoc · 2,962 bytes
references/request-test-authorization.mddoc · 3,737 bytes
references/request-test-params-validation.mddoc · 3,929 bytes
references/request-test-response-status.mddoc · 3,250 bytes
references/system-avoid-sleep.mddoc · 2,691 bytes
references/system-database-state.mddoc · 2,540 bytes
references/system-page-objects.mddoc · 2,713 bytes
references/system-screenshot-on-failure.mddoc · 2,680 bytes
references/system-test-critical-paths.mddoc · 3,198 bytes
references/system-use-accessible-selectors.mddoc · 2,127 bytes

Read excerpt


# Community Ruby on Rails Testing Best Practices

Comprehensive testing guide for Ruby on Rails applications, maintained by Community. Contains 46 rules across 8 categories, prioritized by impact to guide automated test generation, review, and refactoring.

## When to Apply

Reference these guidelines when:
- Writing new RSpec specs for models, requests, system tests, or jobs
- Setting up FactoryBot factories with traits and sequences
- Writing Capybara system tests for user journeys
- Testing background jobs with Sidekiq or Active Job
- Reviewing test code for anti-patterns (mystery guests, flaky tests, slow specs)
- Optimizing test suite performance and CI pipeline speed
- Organizing test files, shared examples, and custom matchers