Individual skill

react-testing-library

React Testing Library best practices for writing maintainable, user-centric tests. Use when writing, reviewing, or refactoring RTL tests. Triggers on test files, testing patterns, getBy/queryBy queries, userEvent, waitFor, and component testing.

skills/.experimental/react-testing-library/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: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

testing Derived category
writing Derived category
engineering Derived category
engineering-web 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

README.mddoc · 4,534 bytes
SKILL.mdcore · 6,622 bytes
assets/templates/_template.mddoc · 834 bytes
metadata.jsonasset · 983 bytes
references/_sections.mddoc · 1,768 bytes
references/a11y-role-queries-verify.mddoc · 1,627 bytes
references/a11y-test-aria-states.mddoc · 1,745 bytes
references/a11y-verify-focus.mddoc · 1,519 bytes
references/anti-container-queries.mddoc · 1,344 bytes
references/anti-empty-waitfor.mddoc · 1,359 bytes
references/anti-implementation-details.mddoc · 1,565 bytes
references/anti-manual-cleanup.mddoc · 1,233 bytes
references/anti-redundant-roles.mddoc · 1,485 bytes
references/anti-unnecessary-act.mddoc · 1,292 bytes
references/assert-accessible-description.mddoc · 1,650 bytes
references/assert-have-value.mddoc · 1,475 bytes
references/assert-jest-dom-matchers.mddoc · 1,525 bytes
references/assert-text-content.mddoc · 1,310 bytes
references/assert-visible-over-in-document.mddoc · 1,362 bytes
references/async-await-findby.mddoc · 1,110 bytes
references/async-findby-over-waitfor.mddoc · 1,306 bytes
references/async-no-side-effects-waitfor.mddoc · 1,373 bytes
references/async-single-assertion-waitfor.mddoc · 1,504 bytes
references/async-waitfor-disappear.mddoc · 1,430 bytes
references/debug-logroles.mddoc · 1,389 bytes
references/debug-screen-debug.mddoc · 1,399 bytes
references/debug-testing-playground.mddoc · 1,348 bytes
references/query-avoid-testid.mddoc · 1,163 bytes
references/query-get-vs-query.mddoc · 1,473 bytes
references/query-label-text-forms.mddoc · 1,216 bytes
references/query-prefer-role.mddoc · 1,104 bytes
references/query-role-name-option.mddoc · 1,124 bytes
references/query-use-screen.mddoc · 1,146 bytes
references/query-within-scope.mddoc · 1,402 bytes
references/setup-custom-render.mddoc · 1,831 bytes
references/setup-fake-timers.mddoc · 1,404 bytes
references/setup-mock-modules.mddoc · 1,322 bytes
references/setup-render-hook.mddoc · 1,585 bytes
references/setup-wrapper-providers.mddoc · 1,317 bytes
references/struct-arrange-act-assert.mddoc · 1,804 bytes
references/struct-avoid-beforeeach-render.mddoc · 1,579 bytes
references/struct-descriptive-names.mddoc · 1,534 bytes
references/struct-one-behavior-per-test.mddoc · 1,777 bytes
references/user-await-interactions.mddoc · 1,313 bytes
references/user-clear-before-type.mddoc · 1,206 bytes
references/user-keyboard-for-special-keys.mddoc · 1,398 bytes
references/user-prefer-userevent.mddoc · 1,340 bytes
references/user-setup-before-render.mddoc · 1,220 bytes

Read excerpt


# React Testing Library Best Practices

Comprehensive testing guide for React components using Testing Library, designed for AI agents and LLMs. Contains 43 rules across 9 categories, prioritized by impact to guide test writing and code review.

## When to Apply

Reference these guidelines when:
- Writing new component tests with React Testing Library
- Selecting queries (getByRole, getByLabelText, etc.)
- Handling async operations in tests (findBy, waitFor)
- Simulating user interactions (userEvent)
- Reviewing tests for anti-patterns and implementation detail testing

## Rule Categories by Priority