# Python Conventions

> Python tooling conventions for this organization. Use when working with Python projects, fixing linting issues, or managing dependencies. Use when this capability is needed.

- Skill: `tomevault-io/python-conventions` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/python-conventions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/python-conventions/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/python-conventions

---


# Python Conventions

## Package Management

Use `uv` exclusively:

```bash
uv sync          # Install dependencies
uv lock          # Regenerate lock file
uv add "pkg"     # Add dependency
uv run <cmd>     # Run in project environment
```

**Lock files**: Never manually edit. Delete and regenerate:
```bash
rm uv.lock && uv lock
```

## Linting

**Tools** (in order):
1. `ruff check --fix` - Linting
2. `ruff format` - Formatting
3. `mypy` - Type checking

**Run all**: `uv run pre-commit run --all-files`

## Inline Ignores

Always include justification:
```python
from module import thing  # noqa: PLC0415 - Lazy import after validation
```

## Environment

Clear inherited environments:
```bash
unset VIRTUAL_ENV
uv sync
```

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