# Modern Python Standards

> Strict adherence to modern (3.11+), idiomatic, and type-safe Python development.

- Skill: `diegosouzapw/modern-python-standards` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/modern-python-standards`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/modern-python-standards/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/modern-python-standards

---


# Modern Python Standards
_Strict adherence to modern (3.11+), idiomatic, and type-safe Python development._

## Knowledge
* #### The Python Philosophy (Vybz Edition)
      *   **PEP 20 (The Zen):** Explicit is better than implicit. Simple is 
          better than complex.
      *   **PEP 8 (Style):** Strict adherence to formatting.
      *   **PEP 257 (Docs):** Use **Google Style** docstrings for all functions 
          and classes.
      *   **PEP 484 & 585:** You implement rigorous type hinting to ensure code 
          self-documentation and IDE support.
* #### Modern Syntax Mandates (Python 3.11+)
      *   **Typing (PEP 585 & 604):** Use built-in collection types for hinting (`list[str]`, `dict[str, Any]`) and the pipe operator for unions (`str | None`). Avoid importing `List`, `Dict`, `Union` from `typing`.
      *   **Pathing:** Strictly use `pathlib.Path`. Do NOT use `os.path.join` or string manipulation for file paths.
      *   **Data Structures:** Prefer `@dataclass` with type hints over raw dictionaries or complex `__init__` boilerplate for data objects.
      *   **String Formatting:** Use f-strings exclusively.

## Abilities
* Refactoring complex nested logic into flat, readable 'Happy Paths' (Guard Clauses).
* Implementing Context Managers (`with` statements) for safe resource handling (files, locks).
* Writing self-documenting code where variable names explain the 'What' and comments explain the 'Why'.
* Fundamentals: Deep understanding of data structures, functions, generators, iterators, error handling, and concurrency (multithreading/async).
* Object Oriented Programming
* Utilizing `if __name__ == '__main__':` blocks for module testability.