Agent skill

Debate Review

by amElnagdy in amElnagdy/review-skills

Two-model debate review of a GitHub PR, GitLab MR, Azure DevOps PR, or local working tree, posted as inline comments or printed.

MITAuto-check passedDevelopment

Install Debate Review

skills CLI
$ npx skills add amElnagdy/review-skills --skill debate-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install amElnagdy/review-skills debate-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/amElnagdy/review-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/debate-review .claude/skills/debate-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
debate-review
GitHub stars
132
Used in
2 other repos
Token cost
~1.1k tokens
SKILL.md length
549 words
Files
14 (incl. scripts, references, assets)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Two-model debate review of a GitHub PR, GitLab MR, Azure DevOps PR, or local working tree, posted as inline comments or printed.

  • Any PR/MR review request
  • SKILL.md covers Run it, After it posts and Artifacts
  • Runs JavaScript scripts from its folder; calls node and az
  • A local review before a PR exists

What it does

Debate Review is an agent skill from amElnagdy/review-skills. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including scripts, reference files and assets (for example `assets/prompts/review-debate.md`, `assets/prompts/review-main.md` and `assets/prompts/review-rebuttal.md`). Compatibility notes: Requires Node 18+, Git 2.31+ for Azure DevOps, gh (GitHub), glab (GitLab) or az (Azure DevOps) authenticated, and delegate-skills installed for the…

It sits in Development, covering Technical documentation. It works with Azure DevOps, GitHub and GitLab. The repository describes itself as: Two-model debate review of PRs and MRs, plus a babysitter that works the review rounds. Skills for any coding agent. The licence is MIT.

When your agent uses it

  • Any PR/MR review request
  • A local review before a PR exists

Example prompts

  • “/debate-review”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Requires Node 18+, Git 2.31+ for Azure DevOps, `gh` (GitHub), `glab` (GitLab) or `az` (Azure DevOps) authenticated, and delegate-skills installed for the main/debate lanes.

What it can do on your machine

Read from SKILL.md and the folder at commit 3cfce39. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 8 files in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • az

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use az, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires Node 18+, Git 2.31+ for Azure DevOps, `gh` (GitHub), `glab` (GitLab) or `az` (Azure DevOps) authenticated, and delegate-skills installed for the main/debate lanes.

    From compatibility in the SKILL.md frontmatter.

Context cost

Debate Review loads about 1.1k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 549 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from amElnagdy/review-skills at commit 3cfce39, republished under its MIT licence (© amElnagdy). 549 words, ~1,066 tokens.

Download SKILL.mdSave it as .claude/skills/debate-review/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
debate-review
description
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.
compatibility
Requires Node 18+, Git 2.31+ for Azure DevOps, `gh` (GitHub), `glab` (GitLab) or `az` (Azure DevOps) authenticated, and delegate-skills installed for the main/debate lanes.
license
MIT
metadata.version
0.2.0

debate-review

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

bash
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 and ssh.dev.azure.com:v3/ remotes.
  • --dry-run prints a live PR review instead of posting it. It does not combine with --local.
  • Azure DevOps needs az logged in (az login) with access to the project. No extension is required, the script talks to the REST API through az rest. A review there is N inline comment threads plus one closed summary thread, since Azure DevOps has no single review object; the alert blockquotes render as plain quotes, which still read.
  • The reviewers are two delegate-skills lanes, review-main and review-debate. If either is missing the script says so. Add them with delegate-setup. Pick two different implementers, since the debate is only worth something when the second model doesn't share the first one's blind spots (main claude or grok, debate codex at high effort is a good pair). For a one-off, pass --main <implementer> or --debate <implementer>. Only implementers whose relay has --read-only are accepted. These two lanes belong to the reviewer. Don't point them at a lane you use for other work, such as a plan-debate lane.
  • --check starts each reviewer on a one-line read-only brief and prints ok or FAIL with the reason per role, exit 1 on any failure. Run it once on every machine after setting up the lanes; it catches a reviewer that is not installed, not signed in, out of quota, or refused by its sandbox before a PR waits on it.
  • Exit code 3 means this head sha already has a debate-review. Re-run with --force to post again.
  • A run takes minutes, since it is two or three implementer sessions back to back. Run it in the background and report the printed URL when it finishes. Don't poll tightly.
Show full SKILL.md (101 more words)Show less

All flags: --help. Contracts: references/schema.md. What gets posted: references/comment-format.md. The reviewer briefs live in assets/prompts/ and the script fills them in; you don't need to read them.

After it posts

Each posted comment carries a <!-- debate-review:<id> status=... --> marker. babysit-pr handles GitHub and GitLab rounds (verify, fix blockers, reply, resolve). It cannot harvest Azure DevOps yet, so relay Azure findings directly to the user. Don't act on the findings yourself unless asked.

Artifacts

~/.cache/debate-review/<owner>__<repo>/<N>/<head>/ holds run.json (all three documents, timings, what was posted) plus main/, debate/, and final/, each with the brief sent and the relay's result.json. --local writes under ~/.cache/debate-review/local/<repo>/<branch>/<head>/ instead.

© amElnagdy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 13 other files (scripts, references, assets) in skills/debate-review of amElnagdy/review-skills.

  • SKILL.md
  • assets/prompts/review-debate.md
  • assets/prompts/review-main.md
  • assets/prompts/review-rebuttal.md
  • references/comment-format.md
  • references/schema.md
  • scripts/lib/diff.mjs
  • scripts/lib/dispatch.mjs
  • scripts/lib/forge.mjs
  • scripts/lib/local.mjs
  • scripts/lib/render.mjs
  • scripts/lib/shell.mjs
  • scripts/lib/validate.mjs
  • scripts/review-pr.mjs

Open the folder on GitHubat commit 3cfce39

Used in 2 other repositories

We found 6 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in amElnagdy/review-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Debate Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Debate Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debate Review this skillamElnagdy/review-skills1322 repos~1.1kAutomated safety check: PassMIT
Writing Styleumputun/cc-thingz485—~1.3kAutomated safety check: PassMIT
Qodo PR Resolversbusso/claudeclaw194—~4kAutomated safety check: PassMIT
Researching With Deepwikiaiskillstore/marketplace433—~1.2kAutomated safety check: PassNone
Promotion Branches E2E Testhardisgroupcom/sfdx-hardis403—~11kAutomated safety check: NotesAGPL-3.0
Authoring GitHub Workflowsdotnet/skills5.6k1 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Writing Style

    umputun/cc-thingz

    A skill your agent uses for technical communication - GitHub/GitLab tickets, PR/MR descriptions, issue comments, code review comments, commit messages.

    485 GitHub stars~1.3k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Qodo PR Resolver

    sbusso/claudeclaw

    Review and resolve PR issues with Qodo - get AI-powered code review issues and fix them interactively (GitHub, GitLab, Bitbucket, Azure DevOps)

    194 GitHub stars~4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Researching With Deepwiki

    aiskillstore/marketplace

    Research GitHub, GitLab, and Bitbucket repositories using DeepWiki MCP server.

    433 GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Promotion Branches E2E Test

    hardisgroupcom/sfdx-hardis

    Runs a full end-to-end test of sfdx-hardis promotion branches and backpromote against real Salesforce orgs and a throwaway repository, then writes a report.

    403 GitHub stars~11k tokensUpdated today
    Testing & QAAuto-check: notes
  • Official

    Author and review GitHub Actions workflow YAML safely so syntactically-valid YAML can't ship a workflow that GitHub Actions refuses to run.

    5.6k GitHub starsUsed in 1 repo~2.3k tokens
    DevOps & CloudAuto-check passed
  • PR

    kdlbs/kandev

    Create a PR from a committed and pushed branch after task-defined checks pass.

    912 GitHub stars~6.3k tokensUpdated today
    Productivity & AutomationAuto-check passed

More from amElnagdy/review-skills

  • Babysit PR

    amElnagdy/review-skills

    Babysit a pull request through its bot review rounds: verify, fix, reply, resolve.

    132 GitHub starsUsed in 2 repos~4.6k tokens
    Auto-check passed

Categories

Questions about Debate Review

What does Debate Review do?

Two-model debate review of a GitHub PR, GitLab MR, Azure DevOps PR, or local working tree, posted as inline comments or printed. Debate Review is an agent skill from amElnagdy/review-skills. Two-model debate review of a GitHub PR, GitLab MR, Azure DevOps PR, or local working tree, posted as inline comments or printed.

When should I use Debate Review?

Debate Review fits situations like: any PR/MR review request; A local review before a PR exists.

How do I install Debate Review in Claude Code?

Run `npx skills add amElnagdy/review-skills --skill debate-review -a claude-code`. Or copy the skill folder (skills/debate-review in amElnagdy/review-skills) into .claude/skills/debate-review in your project. Claude Code loads it when a task matches its description.

How do I install Debate Review in Codex?

Run `npx skills add amElnagdy/review-skills --skill debate-review -a codex`. Or copy the skill folder (skills/debate-review in amElnagdy/review-skills) into .agents/skills/debate-review in your project. Codex loads it when a task matches its description.

Can I use Debate Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add amElnagdy/review-skills --skill debate-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debate-review, .gemini/skills/debate-review, .github/skills/debate-review and .opencode/skills/debate-review in your project.

What does Debate Review need to run?

Going by SKILL.md and its folder, Debate Review needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node and az). Our summary lists: Node.js. Compatibility (from SKILL.md): Requires Node 18+, Git 2.31+ for Azure DevOps, `gh` (GitHub), `glab` (GitLab) or `az` (Azure DevOps) authenticated, and delegate-skills installed for the main/debate lanes..

Does Debate Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Debate Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Debate Review use?

Debate Review is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Debate Review use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Debate Review?

Skills that share tags, products or a category with Debate Review: Writing Style (umputun/cc-thingz, 485 stars), Qodo PR Resolver (sbusso/claudeclaw, 194 stars), Researching With Deepwiki (aiskillstore/marketplace, 433 stars) and Promotion Branches E2E Test (hardisgroupcom/sfdx-hardis, 403 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debate Review?

amElnagdy (a GitHub user) maintains it in amElnagdy/review-skills, which has 132 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 9, 2026.

Source: amElnagdy/review-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.