deb-scripts-formatting

name	deb-scripts-formatting
description	Use when formatting Python code in deb_scripts before or after edits. Covers the required Python style baseline, import sorting, and code formatting with uvx ruff using a maximum line length of 99.

Code formatting

Use this skill whenever Python files were added or changed.

Formatting baseline

• Minimum Python version is 3.12.
• Sort imports with Ruff.
• Run Ruff lint checks.
• Format code with Ruff.
• Maximum line length is 99.

Commands

Format the whole repository:

uvx ruff check --select I --fix . --line-length 99
uvx ruff check --fix . --line-length 99
uvx ruff format . --line-length 99

Format specific files:

uvx ruff check --select I --fix path/to/file.py --line-length 99
uvx ruff check --fix path/to/file.py --line-length 99
uvx ruff format path/to/file.py --line-length 99

Usage rules

• Run import sorting before general Ruff checks and formatting.
• Run uvx ruff check --fix after import sorting to catch and auto-fix non-formatting lint issues where safe.
• Prefer formatting only touched files when the change is small.
• If Ruff reports unrelated pre-existing issues outside the touched scope, do not broaden the task unless asked.
• Keep formatting changes separate from behavioral refactors in your reasoning and validation.