Skip to content

Review Triage Phase

Sorts PR review comments into planned actions and renders them as a markdown checklist

Repository
prisma/orm
Stars
47,663
Licence
Apache-2.0
Files
8 files

What it does

When you ask the agent to triage a pull request's review feedback, this skill makes it read the saved review state, turn each review comment or review body into a structured action item, and decide for each one whether to address it, defer it, or dismiss it. Deferred items must be tracked in a Linear ticket and linked from a thread reply. The result is a validated review-actions.json file and a readable review-actions.md file.

Great for

  • Maintainers or contributors working through a large batch of automated or human PR review comments
  • Teams that use the review-framework workflow with a separate fetch step and implement step

Skip it if

  • Someone who has not already run the review-fetch-phase skill, since it needs a review-state.json file produced by that step
  • Use outside the prisma/orm review-framework setup, because the scripts depend on sibling skill paths and a Linear integration; the triage is an automated judgement and should be checked by a human before replies are posted

Try asking

  • “Triage the review comments on https://github.com/owner/repo/pull/123”
  • “Bootstrap and triage the review actions for this PR into wip/reviews/ and render the markdown”
  • “Plan which review threads to address now and which to defer to Linear for PR 456”
Step-by-step guide: how to use Review Triage PhaseInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 8 original files, the Apache-2.0 licence and an attribution note.

    review-triage-phase.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip review-triage-phase.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip review-triage-phase.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run /review-fetch-phase first so review-state.json exists before triaging
  • Check each decision and the generated Linear links before posting thread replies, since the triager's judgement is automated
  • Keep output directories under the ignored wip/ folder so generated review artifacts are not committed

What's inside

  • agents/review-triager.md
  • package.json
  • scripts/bootstrap-review-actions.mjs
  • scripts/render-review-actions.mjs
  • scripts/render-review-actions.test.mjs
  • scripts/review-artifacts.mjs
  • scripts/validate-review-actions.mjs
  • SKILL.md

Redistributed unmodified from prisma/orm under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.