Skip pull requests
Skip rules that stop Autopilot from reviewing pull requests by title, label or description, the list of skipped pull requests, and how to review one anyway.
Skip rules stop Autopilot from reviewing pull requests that don't need a review, such as test-only changes. One list applies to the whole organization: to every New pull requests rule, and to Every push rules when a push updates an open pull request. A push with no open pull request is never skipped.
Before you start
- The Admin role. Only Admins can change the skip rules; Members can see them. See Roles.
- A rule. The Skipped tab of Autopilot appears once the organization has a New pull requests or Every push rule.
Add skip rules
Open Autopilot and click the Skipped tab.
Under Skip rules, type a condition in Title starts with, Label or Description contains and press Enter. To add several, paste them on separate lines.
Click Save. A rule's row now shows skips and the first condition.
A pull request is skipped when any condition matches:
- Title starts with: the title starts with the text, ignoring case. In a title,
*matches any text, sotest(*):matchestest(api): add fuzzingand*[wip]*matchesAdd login [WIP]. - Label: the pull request has the label, ignoring case, when its review would start. For example,
no-v12skips pull requests labelledno-v12. If the list has a label, V12 waits 10 seconds after a pull request opens, so labels added as it opens count. A label added later does not stop a review that has started. - Description contains: the description contains the text, ignoring case. For example,
[skip v12]matches the descriptionBump the lockfile. [skip v12]. Each of these conditions needs at least 3 characters.
Each list holds up to 100 conditions of up to 100 characters. While you change the title list, Recent pull requests these titles match shows which of the last 30 reviewed pull requests the new titles match.
What a skip does
The rule starts no review and V12 posts nothing on GitHub. Skipped pull requests lists the pull request for 30 days, with the condition that matched. A rule's row shows its latest skip until that pull request is reviewed or the rule runs again.
- Skip rules never apply to pull requests from external authors: a rule set to anyone still reviews them.
- Skip rules never stop a review you ask for from a pull request comment.
- A New pull requests rule reviews each pull request once, so a pull request it already reviewed is not listed when it is marked ready again.
Review a skipped pull request
Click Review now… on its row and confirm. This starts a paid run with the rule's Steers. Members can use Review now… too. You can also ask from a pull request comment.
Once a run reviews the pull request, its row links to that run instead.