Code Reviewer

Automated code review tool that analyzes pull requests and source code across 15+ languages, detecting complexity, risk, code smells, and SOLID violations, then generates structured review reports with verdicts.

✨ What it does

  • Analyzes git diffs to produce a complexity score (1-10), risk category, and file prioritization.
  • Checks code against universal thresholds (function length, file size, method count, parameters, nesting, complexity).
  • Detects hardcoded secrets, SQL/query injection, debug statements, suppression annotations, and TODO/FIXME comments.
  • Loads language-specific rules for Python, TypeScript, Go, Swift, Kotlin, C#, Java, C, C++, Rust, Ruby, PHP, and Dart.
  • Generates review reports in Markdown or JSON with verdicts based on score and issue severity.
  • Supports adding new languages via language files and optional deterministic analyzer extensions.

🎯 When to use it

  • When reviewing a pull request and you need a complexity/risk assessment and prioritized file review order.
  • When you want to check code quality for SOLID violations, code smells, or threshold breaches (long functions, god classes, etc.).
  • When you need a structured review report with a verdict (approve, request changes, block) for a codebase.
  • When you want to detect hardcoded secrets, injection patterns, debug statements, or TODO/FIXME comments in a diff.

🚀 How to use

Trigger by asking to review a pull request or analyze code quality, optionally specifying a language. Provide a repository path or diff. Example prompts:

Review the current branch against main in /path/to/repo
Analyze code quality of /path/to/code --language java
Generate a review report for /path/to/repo

The skill runs scripts (pr_analyzer.py, code_quality_checker.py, review_report_generator.py) and loads universal + language-specific rules.

📄 Output: Produces a structured review report (Markdown or JSON) with findings, scores, and a verdict.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering-team/skills/code-reviewer .claude/skills/code-reviewer

Skill source: engineering-team/skills/code-reviewer/SKILL.md

⚠️ Good to know

Requires Python and the bundled scripts; language-specific detections depend on the language files and may need extension for new languages.

❓ FAQ

What verdicts can the review report generator produce?

Verdicts are Approve (90+ with no high issues), Approve with suggestions (75+ with ≤2 high issues), Request changes (50-74), or Block (<50 or critical issues).

How does the skill decide which language rules to load?

It loads rules/universal.md always, plus one language file based on the file extension (e.g., .py loads languages/python.md).

Can I add support for a new programming language?

Yes, create a languages/<name>.md file with required sections and add the extension to the dispatch table; optionally extend the analyzer scripts for deterministic checks.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.