Complete AI TrainingYourJobSkills for your job

Skills / code-quality

debate-review

Two-model debate review of a GitHub PR, GitLab MR, Azure DevOps PR, or local working tree, posted as inline comments or printed. Use for any PR/MR review request, or a local review before a PR exists.

IT & Software Development

debate-review

When to Use

  • You have a GitHub PR or GitLab MR that needs a thorough pre-merge review.
  • You want a two-model debate (main reviewer vs. debate reviewer) to catch blind spots before posting inline comments.

Two models argue before anything is posted. A main reviewer finds issues. A debate reviewer tries to knock them down and may add its own. The main reviewer then makes the final call, and one review with inline comments lands on the PR or MR. It posts from the user's own gh, glab or az account as a non-approval review or comment. It never approves and never requests changes.

You are the orchestrator. You run one command and relay the result. You do not review the diff yourself, and you do not touch the PR.

Run it

node "<skill-dir>/scripts/review-pr.mjs" --local [--base <ref>]
node "<skill-dir>/scripts/review-pr.mjs" <pr-url | number> [--dry-run]
  • If the user wants a review and there is no PR/MR URL, run --local from the repo (or --repo-dir). Do not invent a URL. Relay stdout. --local never talks to a forge and rejects non-UTF-8 Git paths rather than decoding them lossily.
  • <pr-url> is a GitHub /pull/N, GitLab /-/merge_requests/N, or Azure DevOps
  • /_git/<repo>/pullrequest/N URL (dev.azure.com or the legacy *.visualstudio.com). A bare number resolves against the cwd's origin, including Azure DevOps https an

Subscribers only

The full skill, its 6 bundled files and every download is included with every paid Complete AI plan.

Details

SourceamElnagdy/review-skills
LicenseMIT
Risk labelsafe ("critical" means the skill may run commands or touch files — read before use)
FilesSKILL.md, assets/prompts/review-debate.md, assets/prompts/review-main.md, assets/prompts/review-rebuttal.md, references/comment-format.md, references/schema.md
Added2026-08-26

Related skills

babysit-pr

Babysit a pull request through its bot review rounds: verify, fix, reply, resolve. Use for any babysit or watch-the-PR ask.

clean-code

This skill embodies the principles of "Clean Code" by Robert C. Martin (Uncle Bob). Use it to transform "code that works" into "code that is clean."

code-refactoring-refactor-clean

You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its quality, maintainability, and performance.

code-review-checklist

Comprehensive checklist for conducting thorough code reviews covering functionality, security, performance, and maintainability

codebase-cleanup-tech-debt

Identify technical debt from actual code and change history, estimate its impact, and prioritize bounded improvements with explicit assumptions.

codex-review

Professional code review with auto CHANGELOG generation, integrated with Codex AI. Use when you want professional code review before commits, you need automatic CHANGELOG generation, or reviewing large-scale refactoring.