Skip to content

xpepper/pr-review-agent-skill / pr-review-grill

pr-review-grill

Verified

Use when addressing open pull-request review comments and the user wants to discuss, challenge, and decide each comment one at a time, applying the decisions in one batch at the end or as each one is made. Trigger for requests to grill review feedback, walk through comments individually, debate whether comments are valid, or work through PR feedback collaboratively. Do not use this skill for fast batch triage; use pr-review-loop instead.

FileKindSize
README.mdmarkdown1.6 KB
SKILL.mdskill md16.4 KB
references/triage-guide.mdmarkdown2.8 KB
references/triage-state.mdmarkdown1.7 KB
# PR Review Grill

An [Agent Skills](https://agentskills.io) skill for working through pull
request review feedback collaboratively, one comment at a time.

## What it does

1. Discovers repository safeguards and confirms a healthy baseline, or offers
   to skip that run when CI is already green on the checked-out commit.
2. Collects unresolved inline and top-level PR feedback.
3. Presents one comment with codebase evidence and a provisional assessment.
4. Grills the premise with the user until the classification and action are
   explicit.
5. Persists every decision in `.pr-review/triage.json`.
6. Processes fixes one at a time with safeguards, focused commits, replies,
   and resolution: either all together after a final approval (`batch`, the
   default) or each right after its decision (`apply-as-decided`), optionally
   holding a commit for your review before it is pushed.
7. Reports parked, rejected, and clarification items without silently changing
   them.

## When to use it

Use this skill when you want to discuss review feedback before acting:

```text
Walk through every PR comment with me one at a time and grill the reasoning.
```

```text
Use pr-review-grill on PR #42; don't start coding until we've debated each
comment.
```

For a faster batch triage, use `pr-review-loop` instead.

## Install

```bash
npx skills add xpepper/pr-review-agent-skill/pr-review-grill
```

## Prerequisites

- `gh` CLI or another GitHub client
- `jq`
- The PR branch checked out locally

The skill writes resumable local state to `.pr-review/triage.json`. The
directory must be gitignored.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall