python-anti-patterns

Identify Python anti-patterns in code reviews and refactoring workflows.

1|Updated Jul 24, 2025
One-click install
npx skills add https://github.com/civictechdc/votecatcher --skill python-anti-patterns-civictechdc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-anti-patterns
Source: https://github.com/civictechdc/votecatcher/tree/main/backend/.agent/skills/python-anti-patterns
Command: npx skills add https://github.com/civictechdc/votecatcher --skill python-anti-patterns-civictechdc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Python projects often accumulate repeating anti-patterns that erode maintainability and readability. This skill provides a practical, reusable checklist to spot and fix common Python pitfalls during code reviews, debugging, and refactoring.

Core Features & Use Cases

  • Systematic review of common Python anti-patterns across categories like error handling, configuration, I/O, and typing.
  • Guidance for teams to reinforce best practices during code reviews, onboarding, and pair programming.
  • Use Case: A team audits a noisy module and quickly highlights duplicated retry logic and hard-coded config for remediation.

Quick Start

Run a codebase audit against the checklist and implement fixes for identified anti-patterns.

Frequently Asked Questions about python-anti-patterns

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

FAQPage Schema
What are common Python anti-patterns to look for during code reviews?

Common Python anti-patterns include pitfalls in architecture, error handling, data validation, configuration, I/O, and test quality. Identifying these repeating issues during code reviews helps prevent maintainability and readability erosion across small to large codebases.

How do I audit a Python codebase for bad practices and refactoring opportunities?

Audit a Python codebase by running it against a curated checklist of anti-patterns covering error handling and configuration. This systematic review highlights duplicated logic and hard-coded values, providing actionable fixes to implement during code refactoring sessions.

Does this Python anti-patterns checklist work for large codebases and team onboarding?

Yes, this Python anti-patterns checklist is designed for review workflows across small to large codebases. It provides guidance for teams to reinforce best practices during code reviews, onboarding, and pair programming sessions.

What's the best way to standardize Python best practices across a development team?

The best way to standardize Python best practices is applying a reusable anti-patterns checklist during pair programming and code reviews. This ensures teams consistently spot and fix common pitfalls in data validation, typing, and I/O handling.

Why does duplicated retry logic and hard-coded configuration cause maintainability issues in Python?

Duplicated retry logic and hard-coded configuration cause maintainability issues because they introduce repeating anti-patterns that erode code quality. Cataloging these pitfalls during code audits informs teams and guides actionable remediation.

Can I use this anti-patterns checklist for debugging and refactoring noisy Python modules?

Yes, you can use this anti-patterns checklist for debugging and refactoring noisy Python modules. It systematically catalogs common pitfalls in architecture and error handling, allowing teams to quickly highlight duplicated logic for remediation.