Claude Review Skills

claude-review-skills

Custom [Claude Code](https://claude.ai/code) skills for the GitHub PR review cycle.

The problem

AI coding tools make writing code faster, but the review cycle stays human-speed. Giving feedback, handling comments, resolving threads, committing fixes: the mechanical parts of reviewing eat up time that should go to design judgment.

The solution

Five skills handle the review cycle:

Skill	What it does
/gh-review-pr	Reviews a PR with full codebase context, searches for prior art across the repo and org, presents findings grouped by severity, and submits a batched review
/gh-review-respond	Reads unresolved review comments, categorizes them (fix / discuss / disagree), applies fixes, replies, resolves threads, and commits
/gh-review-cross-pr	Reviews multiple related PRs across repos for consistency: naming, data contracts, deployment ordering, missing changes
/gh-respond-cross-pr	Handles review comments across related PRs as a set, with bot noise detection for cross-PR false positives
/explain-code	Explains code with visual Mermaid diagrams, analogies, and step-by-step walkthroughs. Suggested by review skills for complex changes

All skills accept an optional `--context` argument (a GitHub issue URL) to evaluate changes against the overall goal. All keep the developer in control: you confirm what to post, what to fix, and what to push back on.

Installation

Copy the skill directories into your Claude Code skills folder:

cp -r gh-review-pr gh-review-respond gh-review-cross-pr gh-respond-cross-pr explain-code ~/.claude/skills/

Or clone and symlink (recommended — picks up new skills on `git pull`):

git clone https://github.com/gjoranv/claude-review-skills ~/git/claude-review-skills
for d in ~/git/claude-review-skills/*/SKILL.md; do
  ln -sfn "$(dirname "$d")" ~/.claude/skills/
done

Usage

/gh-review-pr owner/repo#42                    # Review someo