How to Deploy & Use claude-code-review-skill

This guide provides comprehensive instructions for deploying and using the claude-code-review-skill project.

Prerequisites

Before you begin, ensure you have the following installed:

• Claude Code CLI: The command-line interface for Claude Code.
  • Installation: Follow the instructions at claude.com/download.
• GitHub CLI: Required for reviewing Pull Requests.
  • Installation: brew install gh (macOS) or refer to the GitHub CLI documentation for other operating systems.
  • Authentication: gh auth login

Installation

The claude-code-review-skill is installed as a skill for the Claude Code CLI.

Option 1: Add to your Project (Recommended)

This method installs the skill within your project's .claude directory, making it specific to that project.

mkdir -p .claude/skills/code-review
curl -o .claude/skills/code-review/SKILL.md \
  https://raw.githubusercontent.com/anthroos/claude-code-review-skill/main/SKILL.md

Option 2: Global Installation

This method installs the skill globally, making it available for any project you work on with Claude Code.

mkdir -p ~/.claude/skills/code-review
curl -o ~/.claude/skills/code-review/SKILL.md \
  https://raw.githubusercontent.com/anthroos/claude-code-review-skill/main/SKILL.md

Configuration

This project does not require explicit environment variables or API keys beyond the setup of the Claude Code CLI itself. The skill leverages your existing Claude Code CLI configuration.

Build & Run

The claude-code-review-skill is a markdown-based skill for the Claude Code CLI and does not require a separate build process. It is "run" by invoking the claude command with specific prompts.

Usage Examples

Once installed, you can use the skill by calling the claude command with various review prompts:

• Full Comprehensive Review:

  claude "full code review"
  

• Review a Specific Pull Request:

  claude "review PR 123"
  

  (Replace 123 with the actual PR number.)

• Security-Focused Review of Your Changes:

  claude "security review my changes"
  

• Performance Review of a Specific Pull Request:

  claude "check performance issues in PR 456"
  

  (Replace 456 with the actual PR number.)

• Review and Post Comments to GitHub:

  claude "review PR 123 and post comments"
  

  (Requires GitHub CLI authentication.)

Deployment

The claude-code-review-skill is deployed by installing it locally as a skill for the Claude Code CLI. There is no server-side component or external deployment platform required. The reviews are performed locally using your Claude Code CLI installation.

Troubleshooting

• claude command not found:

  • Solution: Ensure the Claude Code CLI is correctly installed and its executable path is included in your system's PATH environment variable. Refer to the Claude Code installation guide.

• gh command not found or authentication issues:

  • Solution: Install GitHub CLI (brew install gh on macOS) and authenticate using gh auth login.

• Skill not recognized by claude:

  • Solution: Double-check the installation path. The SKILL.md file must be located in either .claude/skills/code-review/ (project-specific) or ~/.claude/skills/code-review/ (global). Ensure the directory structure and filename are exact.

• Review output is generic or unhelpful:

  • Solution: Ensure your prompt to claude is clear and specific. The quality of the review often depends on the clarity of the instruction given to Claude.

• curl command not found:

  • Solution: curl is typically pre-installed on most Linux/macOS systems. If not, install it via your system's package manager (e.g., sudo apt install curl on Debian/Ubuntu, brew install curl on macOS).