PR Review Agent Skills

A collection of Agent Skills for automating PR code review workflows. Compatible with Claude Code, GitHub Copilot, Cursor, Windsurf, and 30+ other agents.

Skills

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).

Install:

npx skills add xpepper/pr-review-agent-skill/pr-review-loop

See skill README →

---

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:

npx skills add xpepper/pr-review-agent-skill/copilot-review-loop

See skill README →

---

Ralph Wiggum Loop

The Ralph Wiggum pattern: 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:

npx skills add xpepper/pr-review-agent-skill/ralph-wiggum-loop

See skill README →

---

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:

./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:

# 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