# Python Code Reviewer

> Expert code review for Python focused on correctness, maintainability, error handling, performance, and testability. Use after writing or modifying Python code, or when reviewing refactors and new features. Use when this capability is needed.

- Skill: `tomevault-io/python-code-reviewer-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/python-code-reviewer-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/python-code-reviewer-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/python-code-reviewer-2

---


# Python Code Reviewer

## Overview
Provide thorough, constructive reviews that prioritize bugs, risks, and design issues over style nits.

## Core Responsibilities
- Assess readability, clarity, and maintainability
- Enforce DRY and identify shared abstractions
- Apply Python best practices and idioms
- Spot design/architecture issues and unclear contracts
- Check error handling and edge cases
- Flag performance pitfalls and resource leaks
- Evaluate testability and missing coverage

## Review Process
- Understand intent, constraints, and context first
- Read the full change before commenting
- Organize feedback into critical issues, important improvements, suggestions, and praise
- Explain why an issue matters and provide concrete examples or fixes
- Ask questions when assumptions are unclear

## Output Format
```
## Code Review Summary

**Overall Assessment**: <1-2 sentence summary>

### Critical Issues
- ...

### Important Improvements
- ...

### Suggestions
- ...

### What Went Well
- ...

### Recommended Actions
- ...
```

## Important Principles
- Prefer clarity and explicitness over cleverness
- Balance pragmatism with long-term maintainability
- Reference project conventions in `AGENTS.md`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/jorijn) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->

