How do I install the Python skill?

Run npx skillmds@latest add maroffo/python in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Python safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Python?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Python free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Python?

maroffo (@maroffo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Python by maroffo — Agent Skill

Name: Python
Rating: 4.5 (4 reviews)
Author: maroffo

File contents

ABOUTME: Complete Python development with uv package manager, quality tools, and Docker

ABOUTME: Modern workflow with uv, ruff, ty, pytest, Pydantic, and containerization

Python Development

Quick Reference

uv init myproject && cd myproject
uv add requests pydantic httpx
uv add --dev pytest ruff
uv sync --locked
uv run python main.py
uv run ruff check . && uv run ruff format --check . && uvx ty check && uv run pytest

See also: _AST_GREP.md, _PATTERNS.md, source-control

Version (determine, don't assume)

See ../_LANG_COMMON.md. Fetch the truth:

python3 --version                                                      # local interpreter
cat .python-version 2>/dev/null                                        # pin file (if present)
grep -E '^python' pyproject.toml 2>/dev/null                           # project manifest
curl -s https://endoflife.date/api/python.json | jq -r '.[0].latest'   # latest upstream stable

Pre-Commit Verification (MANDATORY)

make check && make test-e2e must pass (enforced by the pre-commit-gate hook; see ../_LANG_COMMON.md). What make check expands to for Python:

uv run ruff check .
uv run ruff format --check .
uvx ty check
uv run pytest --cov=myproject

Package Management (uv)

UV is the ONLY way. Do NOT use pip/poetry/pipenv. Universal lockfile, fast resolver.

pyproject.toml

[project]
name = "myproject"
requires-python = ">=3.13"
dependencies = ["httpx>=0.27.0", "pydantic>=2.10.0"]

[dependency-groups]
dev = ["pytest>=8.0.0", "ruff>=0.8.0"]

[tool.pytest.ini_options]
testpaths = ["tests"]
asyncio_mode = "auto"

Code Quality

Ruff config:

[tool.ruff]
line-length = 100

[tool.ruff.lint]
select = ["E", "F", "I", "N", "W", "UP", "B", "C4", "SIM", "TCH", "RUF", "PERF"]

Testing: pytest with fixtures, AAA pattern, parametrize. Coverage via --cov.

Pydantic v2

Use Pydantic for all external data boundaries (API I/O, config, queue payloads). Prefer model_validate_json over parse-then-validate. Field(...) for constraints, @field_validator for custom rules.

Code Review Checklist

Public functions have type hints, no unjustified Any
Pydantic for external data, X | None not Optional[X]
Ruff/type checker pass, no bare except:
Context managers, asyncio.gather() for concurrency
Async is not concurrent: no single stateful client (e.g. SQLAlchemy AsyncSession) shared across gather() tasks; one session per task via a factory. A shared session corrupts under concurrent use.
No CPU-bound work inside async def without asyncio.to_thread (parsing, hashing, rendering): it blocks the event loop and serializes every concurrent task. Rule of thumb: a function that awaits nothing probably needs to_thread.
AAA tests, parametrized

For Docker, CI/CD, async patterns, and detailed testing examples, see references/python-patterns.md.

Resources

Astral: uv, Ruff, ty Python: pytest, Pydantic

---name: pythondescription: Python development with uv, type checking, linting, testing, and Docker deployment. Use when working with .py files, pyproject.toml, or user asks about pytest, mypy, ruff, FastAPI, Django.---# ABOUTME: Complete Python development with uv package manager, quality tools, and Docker# ABOUTME: Modern workflow with uv, ruff, ty, pytest, Pydantic, and containerization# Python Development## Quick Reference```bashuv init myproject && cd myprojectuv add requests pydantic httpxuv add --dev pytest ruffuv sync --lockeduv run python main.pyuv run ruff check . && uv run ruff format --check . && uvx ty check && uv run pytest```**See also:** `_AST_GREP.md`, `_PATTERNS.md`, `source-control`---## Version (determine, don't assume)See `../_LANG_COMMON.md`. Fetch the truth:```bashpython3 --version # local interpretercat .python-version 2>/dev/null # pin file (if present)grep -E '^python' pyproject.toml 2>/dev/null # project manifestcurl -s https://endoflife.date/api/python.json | jq -r '.[0].latest' # latest upstream stable```---## Pre-Commit Verification (MANDATORY)`make check && make test-e2e` must pass (enforced by the `pre-commit-gate` hook; see `../_LANG_COMMON.md`). What `make check` expands to for Python:```bashuv run ruff check .uv run ruff format --check .uvx ty checkuv run pytest --cov=myproject```---## Package Management (uv)**UV is the ONLY way. Do NOT use pip/poetry/pipenv.** Universal lockfile, fast resolver.### pyproject.toml```toml[project]name = "myproject"requires-python = ">=3.13"dependencies = ["httpx>=0.27.0", "pydantic>=2.10.0"][dependency-groups]dev = ["pytest>=8.0.0", "ruff>=0.8.0"][tool.pytest.ini_options]testpaths = ["tests"]asyncio_mode = "auto"```---## Code Quality**Ruff config:**```toml[tool.ruff]line-length = 100[tool.ruff.lint]select = ["E", "F", "I", "N", "W", "UP", "B", "C4", "SIM", "TCH", "RUF", "PERF"]```**Testing:** pytest with fixtures, AAA pattern, parametrize. Coverage via `--cov`.---## Pydantic v2Use Pydantic for all external data boundaries (API I/O, config, queue payloads). Prefer `model_validate_json` over parse-then-validate. `Field(...)` for constraints, `@field_validator` for custom rules.---## Code Review Checklist- [ ] Public functions have type hints, no unjustified `Any`- [ ] Pydantic for external data, `X | None` not `Optional[X]`- [ ] Ruff/type checker pass, no bare `except:`- [ ] Context managers, `asyncio.gather()` for concurrency- [ ] **Async is not concurrent**: no single stateful client (e.g. SQLAlchemy `AsyncSession`) shared across `gather()` tasks; one session per task via a factory. A shared session corrupts under concurrent use.- [ ] **No CPU-bound work inside `async def`** without `asyncio.to_thread` (parsing, hashing, rendering): it blocks the event loop and serializes every concurrent task. Rule of thumb: a function that `await`s nothing probably needs `to_thread`.- [ ] AAA tests, parametrizedFor Docker, CI/CD, async patterns, and detailed testing examples, see `references/python-patterns.md`.---## Resources**Astral**: [uv](https://docs.astral.sh/uv/), [Ruff](https://docs.astral.sh/ruff/), [ty](https://docs.astral.sh/ty/)**Python**: [pytest](https://docs.pytest.org/), [Pydantic](https://docs.pydantic.dev/)

Frequently asked questions

Python