pr-review-loop
xpepper/pr-review-agent-skill · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por xpepper/pr-review-agent-skill no skills.sh. Instale com: npx skills add xpepper/pr-review-agent-skill@pr-review-loop
Details
- Kind
- Agent skills
- Publisher
- xpepper
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 3
- Last push
- 2026-10-02T09:32:17Z
- Repository state
- ativo
- Language
- Shell
- Added
- 2026-10-07 05:18:04
- Updated
- 2026-10-07 05:18:04
- Origin id
xpepper/pr-review-agent-skill/pr-review-loop
README
# PR Preparation and Review Agent Skills A collection of [Agent Skills](https://agentskills.io) for preparing changes and automating pull-request review workflows. Compatible with Claude Code, GitHub Copilot, Cursor, Windsurf, and 30+ other agents. ## Skills ### Prepare Review Commits Turns the current uncommitted diff into a logical sequence of validated, self-contained Conventional Commits, ready for pull-request review. Never rewrites history or pushes. Manual-only: it runs only when you invoke it explicitly (`/prepare-review-commits`), never on the agent's own initiative. **Install:** ```bash npx skills add xpepper/pr-review-agent-skill/prepare-review-commits ``` [See skill README →](https://github.com/xpepper/pr-review-agent-skill/blob/HEAD/prepare-review-commits/README.md) --- ### Guided Flow Review Reviews a PR, branch, commit range, or working-tree change collaboratively with its author. It follows the runtime flow instead of diff order, presents one evidence-led step at a time, suggests refactorings where the change introduces or worsens a code smell, and waits for the author to route every finding before changing code. Decisions and progress are kept in a disposable, resumable review TODO. **Install:** ```bash npx skills add xpepper/pr-review-agent-skill/guided-flow-review ``` [See skill README →](https://github.com/xpepper/pr-review-agent-skill/blob/HEAD/guided-flow-review/README.md) --- ### PR Review Loop Addresses all open PR review comments one at a time using an opinionated, resumable workflow. Works with any reviewer (human or bot). Runs in a single session by default. An experimental `--handoff` mode completes one unit of work per session and stops, so you start each fresh session yourself. **Install:** ```bash npx skills add xpepper/pr-review-agent-skill/pr-review-loop ``` [See skill README →](https://github.com/xpepper/pr-review-agent-skill/blob/HEAD/pr-review-loop/README.md) --- ### PR Review Grill Walks through open PR review comments collaboratively, one at a time, challenging premises and recording the user's decision before any code changes. **Install:** ```bash npx skills add xpepper/pr-review-agent-skill/pr-review-grill ``` [See skill README →](https://github.com/xpepper/pr-review-agent-skill/blob/HEAD/pr-review-grill/README.md) --- ### PR Description Review Reviews and improves pull-request descriptions so human and agent reviewers receive the end-to-end flow, external contracts, rollout constraints, accepted limitations, and evidence needed for focused feedback. Read-only: it drafts an improved description without publishing it. **Install:** ```bash npx skills add xpepper/pr-review-agent-skill/pr-description-review ``` [See skill README →](https://github.com/xpepper/pr-review-agent-skill/blob/HEAD/pr-description-review/README.md) --- ### Copilot Review Loop An in-session Copilot-driven review loop: triggers Copilot review, addresses its feedback one comment at a time, and re-triggers Copilot until all critical issues are resolved or 2 cycles are complete. Runs within a single agent session. **Install:** ```bash npx skills add xpepper/pr-review-agent-skill/copilot-review-loop ``` [See skill README →](https://github.com/xpepper/pr-review-agent-skill/blob/HEAD/copilot-review-loop/README.md) --- ### Ralph Wiggum Loop The [Ralph Wiggum pattern](https://ghuntley.com/ralph/): an external shell loop that spawns a fresh agent session for each PR comment. Drop `CODE_REVIEW_PLAN.md` into your project root and run the loop — each invocation fixes one comment, then stops. Works with any agent (Claude, Codex, Cursor, etc.). **Install:** ```bash npx skills add xpepper/pr-review-agent-skill/ralph-wiggum-loop ``` [See skill README →](https://github.com/xpepper/pr-review-agent-skill/blob/HEAD/ralph-wiggum-loop/README.md) --- ## Requirements - `gh` CLI (recommended) or a GitHub token for REST API fallback - Git ## Development ### Skill structure Each skill is a directory containing: ``` <skill-name>/ SKILL.md # required — skill definition with YAML frontmatter README.md # recommended — user-facing documentation references/ # optional — supporting reference documents ``` The `SKILL.md` frontmatter must include at minimum `name` and `description`. See existing skills for the full set of supported fields (`license`, `compatibility`, `metadata`, `allowed-tools`). ### Packaging After adding or modifying a skill, regenerate the `.skill` package: ```bash ./package-skill.sh ``` The script auto-discovers all directories that contain a `SKILL.md` and packages each one. Generated `.skill` files are gitignored (build artifacts). ### Testing a skill After pushing changes, verify a skill installs and removes correctly: ```bash # Install (--yes skips interactive prompts) npx skills add xpepper/pr-review-agent-skill/<skill-name> --yes # Verify the skill description appears and the install path looks correct, then remove npx skills remove <skill-name> ``` Note: without `--global`, skills are installed project-locally into `.agents/skills/` (gitignored). ## License MIT