---
name: coderabbit-setup
description: Check CodeRabbit setup for local CLI reviews and, when configured, connect the host's CodeRabbit MCP tools. Use for onboarding, reconnection, or diagnosing separate MCP and CLI sign-ins.
metadata:
  version: "0.1.0"
title: coderabbit-setup
canonical_url: https://skilld.dev/gh/coderabbitai/skills/coderabbit-setup
last_updated: 2026-11-19T18:12:37.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> If the user asked to install this Skill, run `npx skilld install coderabbitai/skills/coderabbit-setup`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/coderabbit-setup`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/coderabbitai/skills/coderabbit-setup) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/coderabbit-setup`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/coderabbit-setup --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/coderabbit-setup --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# Set up CodeRabbit

Report remote connection and local review readiness separately. Setup alone
does not authorize a review or source upload.

## Connect remote tools

Check whether the installed package or host provides a CodeRabbit MCP connection
to `https://mcp.coderabbit.ai/`. Use the host's own sign-in flow:

- **Antigravity:** use the plugin's `coderabbit_coderabbit` server. Open the
  plugin's Accounts tab or Customizations > Installed > MCP Servers in the App.
  In the CLI, inspect `/mcp` or choose Sign in on the plugin in `/plugin`.
- **Claude:** use Connect or Reconnect for the CodeRabbit server. In Claude
  Code, inspect the connection through `/mcp`.
- **Codex and other hosts:** use the configured CodeRabbit connection when
  present. A skills-only installation can proceed directly to local CLI setup.
  Report remote tools as unconfigured if the host has no CodeRabbit connection.

Let the user complete consent and select the intended organization. If the
host requests an authorization code, the user enters it directly into the
host's authentication dialog, never into chat. Do not read credential stores
or copy tokens between the host and CLI. Preserve other connections.
If a duplicate connection prevents discovery, explain the conflict before
changing it.

In Antigravity, if submitting the code fails with `invalid_grant` or “Invalid
authorization code,” use the native Restart sign-in action and complete a fresh
flow. Do not resubmit the rejected code or infer its cause from that message
alone. If the fresh flow also fails, report the error and stop retrying.

Verify the selected account and organization using `connection_status` or
`get_me` when available. A browser success page alone does not establish tool
discovery or access. If tools are absent, report the observed connection error
and use the host's reconnect flow. Do not promise capabilities beyond the
granted scopes, organization, plan and permissions.

## Prepare local reviews

Skip this step for a remote-tools-only request. Local reviews require a Git
working tree, the official CodeRabbit CLI, its own sign-in, and host
execution/network permission. Locate the installed
`code-review` skill and follow its `references/auth-recovery.md` for trusted
CLI discovery and authentication checks. That reference also routes to
Antigravity sandbox recovery when an installed executable is inaccessible.
Hand off missing CLI installation or login to the user through the official
[CLI instructions](https://docs.coderabbit.ai/cli).

MCP sign-in does not authenticate the CLI. Do not call `start_code_review`,
reserve a review, install a hook, or pass an MCP handoff into shell commands.
If local execution is unavailable, report that separately from the observed
MCP connection status. Remote tools remain usable only if the MCP check succeeded.
Configuration uses the installed `coderabbit-config` skill and needs no login.

If the user already requested a review, continue with the installed
`code-review` skill and preserve their scope. Otherwise summarize what is
ready and suggest “Review my uncommitted changes. Review only; do not edit.”
