Individual skill
python-project
Modern Python project architecture guide for 2025. Use when creating Python projects (APIs, CLI, data pipelines). Covers uv, Ruff, Pydantic, FastAPI, and async patterns.
skills/python-project/SKILL.md
Source commit 238e07625aeca5bcf0d6f7cb3e2d07f94c717194
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 6, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 290
- Repository last updated
- Nov 4, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- ai-agents Repository topic
- ai-coding-assistant Repository topic
- claude Repository topic
- claude-code Repository topic
- developer-tools Repository topic
- productivity Repository topic
- automation Repository topic
- agent-skills Repository topic
- code-review Repository topic
- prompt-engineering Repository topic
- engineering Derived category
- data Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesreference/architecture.mddoc · 10,196 bytesreference/extended.mddoc · 2,692 bytesreference/patterns.mddoc · 13,194 bytesreference/tech-stack.mddoc · 8,665 bytestemplates/api/.env.exampleasset · 215 bytestemplates/api/.python-versionasset · 5 bytestemplates/api/Makefileruns · 1,483 bytestemplates/api/pyproject.tomlasset · 787 bytestemplates/api/src/myapp/__init__.pyruns · 58 bytestemplates/api/src/myapp/__main__.pyruns · 302 bytestemplates/api/src/myapp/api/__init__.pyruns · 17 bytestemplates/api/src/myapp/api/deps.pyruns · 525 bytestemplates/api/src/myapp/api/middleware.pyruns · 662 bytestemplates/api/src/myapp/api/routes/__init__.pyruns · 186 bytestemplates/api/src/myapp/api/routes/user.pyruns · 978 bytestemplates/api/src/myapp/config.pyruns · 713 bytestemplates/api/src/myapp/core/__init__.pyruns · 278 bytestemplates/api/src/myapp/core/exceptions.pyruns · 1,438 bytestemplates/api/src/myapp/core/logging.pyruns · 1,258 bytestemplates/api/src/myapp/main.pyruns · 718 bytestemplates/api/src/myapp/models/__init__.pyruns · 131 bytestemplates/api/src/myapp/models/user.pyruns · 679 bytestemplates/api/src/myapp/services/__init__.pyruns · 103 bytestemplates/api/src/myapp/services/user.pyruns · 2,198 bytestemplates/api/tests/__init__.pyruns · 21 bytestemplates/api/tests/conftest.pyruns · 528 bytestemplates/api/tests/test_user.pyruns · 2,975 bytes
Read excerpt
# Python Project Architecture
## Core Principles
- **Type hints everywhere** — Pydantic for runtime, mypy for static
- **uv for everything** — Package management, virtualenv, Python version
- **Ruff only** — Replace Flake8 + Black + isort with single tool
- **src layout** — All code under `src/` directory
- **pyproject.toml only** — No setup.py, no requirements.txt
- **Async all the way** — Once async, stay async through call chain
- **No backwards compatibility** — Delete, don't deprecate. Change directly
- **LiteLLM for LLM APIs** — Use LiteLLM proxy for all LLM integrations
---
