Claude Code Plugins

Community-maintained marketplace

python-code-review

@existential-birds/beagle

1

0

Reviews Python code for type safety, async patterns, error handling, and common mistakes. Use when reviewing .py files, checking type hints, async/await usage, or exception handling.

Install Skill

1Download skill

2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name	python-code-review
description	Reviews Python code for type safety, async patterns, error handling, and common mistakes. Use when reviewing .py files, checking type hints, async/await usage, or exception handling.

Python Code Review

Quick Reference

Issue Type	Reference
Missing/wrong type hints, Any usage	references/type-safety.md
Blocking calls in async, missing await	references/async-patterns.md
Bare except, missing context, logging	references/error-handling.md
Mutable defaults, print statements	references/common-mistakes.md

Review Checklist

Type hints on all function parameters and return types
No Any unless necessary (with comment explaining why)
Proper T | None syntax (Python 3.10+)
No blocking calls (time.sleep, requests) in async functions
Proper await on all coroutines
No bare except: clauses
Specific exception types with context
raise ... from to preserve stack traces
No mutable default arguments
Using logger not print() for output
f-strings preferred over .format() or %

When to Load References

Reviewing function signatures → type-safety.md
Reviewing async def functions → async-patterns.md
Reviewing try/except blocks → error-handling.md
General Python review → common-mistakes.md

Review Questions

Are all function signatures fully typed?
Are async functions truly non-blocking?
Do exceptions include meaningful context?
Are there any mutable default arguments?