# Modern Python Standards

> Strict adherence to modern (3.11+), idiomatic, and type-safe Python development. Use when this capability is needed.

- Skill: `tomevault-io/modern-python-standards` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/modern-python-standards`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/modern-python-standards/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nick-orton) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->