What problem does it solve?
This skill reduces bugs, inconsistent style, and architecture drift by enforcing a consistent set of Python best practices and tool-based checks across the codebase.
Core Features & Use Cases
- Enforces type hints for public APIs, meaningful exception handling, and Clean Architecture layering to improve maintainability.
- Integrates tool-driven checks with Ruff and pyrefly rules, recommends Pydantic v2 or frozen dataclasses for boundaries, and prescribes pytest TDD and resource-safe async patterns.
- Ideal for code authors and reviewers working on Python services such as news-creator, tag-generator, metrics, recap-subworker, and recap-evaluator.
Quick Start
Read docs/best_practices/python.md and apply its rules when writing or reviewing any Python files in the repository.