PR Status Triage

What it does

When your agent uses it

• Investigating failing CI jobs
• PR review feedback

Example prompts

• “/pr-status-triage”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Read scripts/pr-status/results/index.md.
2. 2For a targeted review question, inspect the relevant thread-{N}.md, review-{id}.md, or comment-{id}.md files. For full triage, also…
3. 3Prioritize blocking jobs first: build, lint, types, then test jobs.
4. 4Treat failures as real until disproven; check the "Known Flaky Tests" section before calling anything flaky.
5. 5Reproduce test failures locally with the same mode and environment as CI (e.g. dev or start, webpack or turbopack).
6. 6After addressing review comments, reply to the thread describing what was done, then resolve it. Use reply-and-resolve-thread to do both…
7. 7When the only remaining failures are known flaky tests and no code changes are needed, retrigger the failing CI jobs with gh run rerun…

What it can do on your machine

Read from SKILL.md and the folder at commit d8bfc3c. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • node
  • pnpm
  • cargo
  • gh

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use pnpm and gh, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PR Status Triage loads about 866 tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 307 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~78

When it runs · the whole SKILL.md, loaded when a task matches

~866

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vercel/next.js at commit d8bfc3c, republished under its MIT licence (© vercel). 307 words, ~866 tokens.

name

pr-status-triage

description

Triage CI failures and PR review comments using scripts/pr-status.js. Use when investigating failing CI jobs, flaky tests, or PR review feedback. Covers blocker-first prioritization (build > lint > types > tests), CI env var matching for local reproduction, and the Known Flaky Tests distinction.

metadata.internal

true

# Development mode with Turbopack
pnpm test-dev-turbo test/path/to/test.ts

# Production build and start with Webpack
pnpm test-start-webpack test/path/to/test.ts

node scripts/pr-status.js                  # current branch PR
node scripts/pr-status.js <number>         # specific PR
node scripts/pr-status.js [PR] --wait      # background mode, waits for CI to finish
node scripts/pr-status.js [PR] --comments-only  # reviews/comments only; skips CI jobs
node scripts/pr-status.js --skip-flaky-check  # skip flaky test detection

node scripts/pr-status.js reply-thread <threadNodeId> "<body>"           # reply to a review thread
node scripts/pr-status.js resolve-thread <threadNodeId>                  # resolve a review thread
node scripts/pr-status.js reply-and-resolve-thread <threadNodeId> "<body>"  # reply and resolve in one step

© vercel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in .agents/skills/pr-status-triage of vercel/next.js.

• SKILL.md
• local-repro.md
• workflow.md

Open the folder on GitHubat commit d8bfc3c