Stats
Actions
Available In
Tags
Plugin
Python Best Practices
Modern Python 3.12+ patterns your AI agent should use. Type hints, async/await, Pydantic v2, uv package manager, match statements, and project structure.
What's Inside
README
Python Best Practices
Modern Python 3.12+ patterns your AI agent should use. Type hints with X | Y syntax, Pydantic v2,
uv package manager, match statements, pathlib, pyproject.toml, TaskGroup, and PEP 695
generics.
AI coding assistants generate
from typing import List, Union, Optional, use Pydantic v1 decorators, createsetup.py, and reach foros.pathinstead ofpathlib. This plugin keeps your agent on Python 3.12+ patterns.
Install
Cursor / Claude Code / Windsurf
npx skills add ofershap/python-best-practices
Or copy skills/ into your .cursor/skills/ or .claude/skills/ directory.
What's Included
| Type | Name | Description |
|---|---|---|
| Skill | python-best-practices | 15 rules for type hints, Pydantic v2, uv, pathlib, match/case, TaskGroup, and more |
| Rule | best-practices | Always-on behavioral rule that enforces Python 3.12+ patterns |
| Command | /audit | Scan your codebase for outdated Python patterns |
What Agents Get Wrong
| What the agent writes | What Python 3.12+ uses |
|---|---|
from typing import List, Union, Optional | list[str], X | Y, X | None |
@validator, @root_validator | field_validator, model_validator (Pydantic v2) |
class Config: in Pydantic models | model_config = ConfigDict(...) |
os.path.join(), string paths | pathlib.Path for all file operations |
setup.py, requirements.txt | pyproject.toml with uv |
TypeVar("T") + Generic[T] | def f[T](x: T) -> T (PEP 695) |
asyncio.gather() | TaskGroup for structured concurrency |
Related Plugins
- fastapi-best-practices - FastAPI async patterns, Depends(), project structure
- typescript-best-practices - TypeScript 5.x strict patterns
If this helped your workflow, a star helps others find it.
Author
License
MIT
Stats
Version0.1.0
LanguageJavaScript
Stars0
MaintenancePoor
LicenseMIT
Last Commit
Added
Tags
Categories
