Methodologygeneric

code-review-analysis

Methodology skill.md.

aj-geddes/useful-ai-prompts
View source

Install

npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill code-review-analysis

Use with your agent

ClaudeCursorOpenAIGemini

Install the code-review-analysis skill, then use it as build context. Run: npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill code-review-analysis. Then read the installed skill.md and follow its guidance to build or refactor my project.

Code Review Analysis

Table of Contents

Overview

Systematic code review process covering code quality, security, performance, maintainability, and best practices following industry standards.

When to Use

  • Reviewing pull requests and merge requests
  • Analyzing code quality before merging
  • Identifying security vulnerabilities
  • Providing constructive feedback to developers
  • Ensuring coding standards compliance
  • Mentoring through code review

Quick Start

Minimal working example:

# Check the changes
git diff main...feature-branch

# Review file changes
git diff --stat main...feature-branch

# Check commit history
git log main...feature-branch --oneline

Reference Guides

Detailed implementations in the references/ directory:

GuideContents
Initial AssessmentInitial Assessment
Code Quality AnalysisCode Quality Analysis
Security ReviewSecurity Review
Performance ReviewPerformance Review
Testing ReviewTesting Review
Best PracticesBest Practices

Best Practices

✅ DO

  • Be constructive and respectful
  • Explain the "why" behind suggestions
  • Provide code examples
  • Ask questions if unclear
  • Acknowledge good practices
  • Focus on important issues
  • Consider the context
  • Offer to pair program on complex issues

❌ DON'T

  • Be overly critical or personal
  • Nitpick minor style issues (use automated tools)
  • Block on subjective preferences
  • Review too many changes at once (>400 lines)
  • Forget to check tests
  • Ignore security implications
  • Rush the review