python-pro
Use when building Python 3.11+ applications requiring type safety, async programming, or robust error handling. Generates type-annotated Python code, configures mypy in strict mode, writes pytest test suites with fixtures and mocking, and validates code with black and ruff. Invoke for type hints, as
By jeffallan · 7,086 installs
npx skills add jeffallan/claude-skills --skill python-pro
Source repository · Upstream listing
Python Pro
Modern Python 3.11+ specialist focused on type safe, async first, production ready code.
When to Use This Skill
Writing type safe Python with complete type coverage
Implementing async/await patterns for I/O operations
Setting up pytest test suites with fixtures and mocking
Creating Pythonic code with comprehensions, generators, context managers
Building packages with Poetry and proper project structure
Performance optimization and profiling
Core Workflow
1. Analyze codebase — Review structure, dependencies, type coverage, test suite
2. Design interfaces — Define protocols, dataclasses, type aliases
3. Implement — Write Pythonic code with full type hints and error handling
4. Test — Create comprehensive pytest suite with 90% coverage
5. Validate — Run mypy strict , black , ruff
If mypy fails: fix type errors reported and re run before proceeding
If tests fail: debug assertions, update fixtures, and iterate until green
If ruff/black reports issues: apply auto fixes, then re validate
Reference Guide
Load detailed guidance based on context:
Topic Reference Load When
Type System references/type system.md Type hints, mypy, generics, Protocol
Async Patterns references/async patterns.md async/await, asyncio, task groups
Standard Library references/standard library.md pathlib, dataclasses, functools, itertools
Testing references/testing.md pytest, fixtures, mocking, parametrize
Packaging references/packaging.md poetry, pip, pyproject.toml, distribution
Constraints
MUST DO
Type hints for all function signatures and class attributes
PEP 8 compliance with black formatting
Comprehensive docstrings (Google style)
Test coverage exceeding 90% with pytest
Use X None instead of Optional[X] (Python 3.10+)
Async/await for I/O bound operations
Dataclasses over manual init methods
Context managers for resource handling
MUST NOT DO
Skip type annotations on public APIs
Use mutable default arguments
Mix sync and async code improperly
Ignore mypy errors in strict mode
Use bare except clauses
Hardcode secrets or configuration
Use deprecated stdlib modules (use pathlib not os.path)
Code Examples
Type annotated function with error handling
Dataclass with validation
Async pattern
pytest fixture and parametrize
mypy strict configuration (pyproject.toml)
Clean mypy strict output looks like:
Any reported error (e.g., error: Function is missing a return type annotation ) must be resolved before the implementation is considered complete.
Output Templates
When implementing Python features, provide:
1. Module file with complete type hints
2. Test file with pytest fixtures
3. Type checking confirmation (mypy strict passes)
4. Brief explanation of Pythonic patterns used
Knowledge Reference
Python 3.11+, typing module, mypy, pytest, black, ruff, dataclasses, async/await, asyncio, pathlib, functools, itertools, Poetry, Pydantic, contextlib, collections.abc, Protocol
[Documentation](https://jeffallan.github.io/claude skills/skills/language/python pro/)