Python Best Practice Checker

What it does

This skill transforms your AI agent into a senior Python architect, capable of performing deep-tissue audits of Python codebases. It goes beyond simple linting by analyzing code against PEP 8 style guides, PEP 484/585 type-hint standards, and modern Python 3.10+ idioms. It identifies security vulnerabilities like eval() injection, performance bottlenecks like O(n²) string concatenation, and common anti-patterns like mutable default arguments.

Why use this skill

While standard LLMs can write Python, they often default to outdated syntax or overlook subtle resource leaks and type inconsistencies. This skill enforces a rigorous, multi-phase audit process (Style, Type, Anti-pattern, Security, and Performance) that mimics a professional human peer review. It ensures your agent-generated code is production-ready, highly maintainable, and secure.

Supported standards and tools

• Formatting: PEP 8, Black-compatibility, and import organization.
• Typing: Modern PEP 604 (X | Y) syntax and PEP 585 generics.
• Security: Bandit-level detection of SQLi, hardcoded secrets, and unsafe deserialization.
• Performance: Iterator optimization and regex compilation strategies.

The Output

The skill produces a structured report grouping findings by severity (Critical to Info). Each finding includes the problematic line, a category, an explanation of the underlying risk, and a "Modern Python" code correction. It concludes with an overall quality grade (A-F) and a prioritized list of high-impact fixes.