python-code-review
This skill systematically audits Python code across five key dimensions: PEP8 compliance, type annotation completeness, async/await correctness, exception handling rigor, and frequent pitfalls like mutable defaults. It provides a checklist-driven review workflow with reference guides for each category and context-sensitive rules to avoid false positives.
Python Code Review examines your Python files for type safety, async correctness, and error handling issues.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-21
Python Code Review examines your Python files for type safety, async correctness, and error handling issues. This skill systematically audits Python code across five key dimensions: PEP8 compliance, type annotation completeness, async/await correctness, exception handling rigor, and frequent pitfalls like mutable defaults. It provides a checklist-driven review workflow with reference guides for each category and context-sensitive rules to avoid false positives.
Use it when
- Yes.
- python-code-review ensures proper async/await usage by detecting blocking calls in async functions, validating await placement.
Verify before relying
Read SKILL.md below before installing (6 files). Open directory: indexed for reading, not audited.
Install
existential-birds/beagle/python-code-review · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does python-code-review check for in type hints?
python-code-review reviews Python code for type safety and validates type annotations across function signatures, return types, and variable declarations. It ensures type hints are complete and correctly applied, helping catch type-related bugs before runtime.
Can python-code-review check a Python file for PEP8 style?
Yes. python-code-review checks Python file compliance with the PEP8 style guide, validating formatting, naming conventions, whitespace, line length, and other style standards to ensure your code follows Python community guidelines.
How does python-code-review validate async/await patterns?
python-code-review ensures proper async/await usage by detecting blocking calls in async functions, validating await placement, and checking for common async mistakes. It verifies that asynchronous code doesn't inadvertently block execution.
What error handling issues does python-code-review detect?
python-code-review validates error handling and exception patterns, including bare except clauses, overly broad exception catching, missing exception handlers, and improper error propagation. It promotes exception handling best practices.
Does python-code-review find common Python mistakes?
Yes. python-code-review detects common Python anti-patterns and mistakes such as mutable defaults in function arguments, improper imports organization, and other frequent pitfalls. It provides checklist-driven review with context-sensitive rules to minimize false positives.
What is python-code-review's license?
python-code-review is released under the Apache-2.0 license, allowing free use, modification, and distribution with appropriate attribution.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Python Code Review
Quick Reference
| Issue Type | Reference |
|---|---|
| Indentation, line length, whitespace, naming | references/pep8-style.md |
| 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
PEP8 Style
- [ ] 4-space indentation (no tabs)
- [ ] Line length ≤79 characters (≤72 for docstrings/comments)
- [ ] Two blank lines around top-level definitions, one within classes
- [ ] Imports grouped: stdlib → third-party → local (blank line between groups)
- [ ] No whitespace inside brackets or before colons/commas
- [ ]
(truncated - see the full file via the links below)
File tree — 6 files
plugins/beagle-python/skills/python-code-review/SKILL.md
plugins/beagle-python/skills/python-code-review/references/async-patterns.md
plugins/beagle-python/skills/python-code-review/references/common-mistakes.md
plugins/beagle-python/skills/python-code-review/references/error-handling.md
plugins/beagle-python/skills/python-code-review/references/pep8-style.md
plugins/beagle-python/skills/python-code-review/references/type-safety.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Review Python code for type safety and async correctness”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
This skill systematically audits Swift source files for concurrency hazards, including unsafe async/await patterns, actor reentrancy, Sendable conformance gaps, and memory leaks from retain cycles. It establishes Swift language version context upfront, reads full enclosing symbols rather than diffs alone, and applies targeted checklists for error handling, force unwraps, and closure capture semantics before reporting findings.
Go Code Review systematically audits Go source files against idiomatic patterns, error handling practices, concurrency safety, and common pitfalls. The skill applies version-aware guidance based on your project's Go baseline, covering generics, structured logging, and loop variable semantics. It follows a structured workflow that reads full context, applies targeted checklists, and verifies findings before reporting issues with severity calibration.
This skill audits shadcn/ui and Radix-based React components against best practices for variant-driven styling, accessible state handling, and composable component architecture. It checks CVA pattern separation, asChild slot integration, focus and ARIA attributes, and data-slot targeting across multi-part components.
Troubleshoot PydanticAI agents with guidance on tool decorator patterns, dependency wiring, async/sync contexts, and output validation. Covers common mistakes like missing RunContext parameters, type mismatches, and streaming consumption, plus debugging techniques using message capture and tracing.
Prompt Improver refines code-related prompts by evaluating task clarity, investigation depth, verification steps, and scope control. It applies transformation rules to strengthen prompts for implementation, debugging, refactoring, code review, and testing tasks. The skill ensures prompts follow investigation-first principles and include appropriate verification checks before execution.
Learn to use ty, Astral's high-performance Rust-based type checker for Python. This skill covers adding type annotations, resolving type errors, configuring rules, and migrating from mypy or pyright. Explore advanced patterns like intersection types and protocols, plus editor integration for VS Code, Cursor, Neovim, and PyCharm.
More skills woocommerce-code-review (MIT) · swiftdata-code-review (Apache-2.0) · watchos-code-review (Apache-2.0) · python-pro (MIT)