python-code-review

Python Code Review Skill

A specialized skill for reviewing Python code with focus on PEP8 compliance, type hints, modern best practices, and code quality.

Overview

This skill enables Claude to autonomously review Python code for compliance with modern Python standards, including PEP8 style guidelines, type hint coverage, proper structure, and common anti-patterns. It promotes clean, maintainable, and type-safe Python code.

Capabilities

When activated, this skill provides:

1. PEP8 Compliance Review

   • Check naming conventions (snake_case, PascalCase)
   • Verify line length (88 characters)
   • Review whitespace and indentation
   • Check import ordering and grouping
   • Validate docstring presence and format

2. Type Hints Validation

   • Ensure all functions have type hints
   • Check for proper return type annotations
   • Validate use of modern type syntax (list[], dict[] over List[], Dict[])
   • Verify Optional[] vs None union types
   • Check for Any types (discourage overuse)

3. Code Structure & Organization

   • Review module structure and imports
   • Check for proper __init__.py usage
   • Validate entry points (__main__.py)
   • Review function/class organization
   • Assess module coupling and cohesion

4. Best Practices Enforcement

   • Check for use of context managers (with statements)
   • Validate exception handling
   • Review string formatting (f-strings preferred)
   • Check for proper constant definitions
   • Assess use of comprehensions vs loops

5. Common Anti-Patterns Detection

   • Mutable default arguments
   • Bare except clauses
   • Using global keyword unnecessarily
   • Poor variable naming
   • Overly complex functions (high cyclomatic complexity)

6. Documentation Quality

   • Check for docstrings on public functions/classes
   • Validate docstring format (Google/NumPy style)
   • Review parameter documentation
   • Check for return value documentation
   • Assess example usage in docstrings