python-code-review
SKILL.md
Python Code Review (PEP 8 + Google Style Guide)
Perform systematic code reviews of Python files following PEP 8 and Google Python Style Guide standards.
Review Philosophy
"Code is read much more often than it is written." - Guido van Rossum
Key Principle: A foolish consistency is the hobgoblin of little minds. Consistency within a project is more important than rigid adherence to rules. When in doubt, prioritize:
- Consistency within one function/module (most important)
- Consistency within the project
- Consistency with PEP 8/Google Style Guide
Know when to be inconsistent:
- When applying the guideline makes code less readable
- To match surrounding code style (but consider refactoring)
- When code predates the guideline
- For backwards compatibility