clean-python
Installation
SKILL.md
Clean Python: Index And Review Guide
Use this as the Python entry point. It routes broad review work to focused skills and summarizes the rules most likely to affect design. Prefer explicit runtime behavior, typed public contracts, and simple module boundaries over clever language tricks.
Comments (C1-C5)
- C1: No metadata in comments (use Git)
- C2: Delete obsolete comments immediately
- C3: No redundant comments
- C4: Write comments well if you must
- C5: Never commit commented-out code
Error Handling (EH1-EH4)
- EH1: Raise useful exception objects with context
- EH2: Catch specific exceptions; avoid bare
except - EH3: Do not swallow failures
- EH4: Use typed recoverable results only when the project style or domain warrants it