Skip to content
Kitbay
Skill

gate-tests

MITUpdated on Nov 11, 2026143,470GitHub stars

A maintainer skill in the Next.js repository, marked internal, for handling tests that fail only under some test-matrix setting such as dev mode, a bundler or an experimental flag.

What the skill teaches

A maintainer skill in the Next.js repository, marked internal, for handling tests that fail only under some test-matrix setting such as dev mode, a bundler or an experimental flag. Rather than skipping them, the agent marks them with the repository's gate and force-gate comments, which still run the test body and report when a gated test starts passing. It explains when to fork behaviour inside the test with a runtime gate call, when to gate a whole describe block, when a test cannot run at all, and how to tie an experimental flag to a test axis letter. It lists pitfalls in comment placement and the pnpm commands for each kind of run.

Capabilities

  • Choose between gate and force-gate test directives
  • Replace skipped tests with gated ones
  • Tie experimental flags to a test axis
  • Run gated tests in each mode