py-reviewer

Review Python code for idiomatic patterns and robust typing.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/RaNDoM6913/claude-code-superkit --skill py-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: py-reviewer
Source: https://github.com/RaNDoM6913/claude-code-superkit/tree/main/packages/codex/skills/py-reviewer
Command: npx skills add https://github.com/RaNDoM6913/claude-code-superkit --skill py-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates Python code reviews to enforce idiomatic patterns, stronger typing, and robust exception handling, reducing review time and improving code quality.

Core Features & Use Cases

  • Checklist-driven quick scan to surface violations before deep analysis.
  • Phase-based analysis prompts that guide reviewers through intent, failure modes, edge cases, and cross-component impact.
  • Architecture-awareness that detects patterns in FastAPI, Django, and plain Python projects and suggests targeted improvements.

Quick Start

Run a Phase 1 checklist on the target Python module, then perform Phase 2 reasoning and report findings.

Frequently Asked Questions about py-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Python code review for type hints and exception handling?

Automate Python code review using a checklist-driven scan and phase-based analysis to enforce type hints and robust exception handling. This structured approach surfaces violations and provides actionable findings for code quality and safety.

Does this code review tool work with FastAPI and Django projects?

Yes, this code review tool works with FastAPI, Django, and plain Python projects. It features architecture-awareness that detects specific framework patterns and suggests targeted improvements for idiomatic code.

What is the best way to check async patterns in Python code?

The best way to check async patterns is using a phase-based analysis that evaluates intent, failure modes, and edge cases. This structured review guides you through explicit checks to surface non-idiomatic async implementations.

How to perform a structured Python code review step by step?

Perform a structured Python code review by first running a Phase 1 checklist to surface violations, then executing Phase 2 reasoning. This deep analysis evaluates cross-component impact and generates actionable findings.

When do I need a phase-based analysis for Python code?

You need a phase-based analysis for Python code when a quick scan is insufficient to evaluate failure modes and cross-component impact. It guides manual reviews through edge cases to ensure robust typing and safe exception handling.