atelier-python-build-tools_skill

Overview

This skill provides a focused toolkit for modern Python projects using uv, mise, ruff, basedpyright, and pytest. It helps you create a minimal pyproject.toml, manage dependencies and environments, enforce linting/formatting, run strict type checks, and configure repeatable test runs. The goal is fast, opinionated developer workflows that prioritize code quality and reproducibility.

How this skill works

The skill scaffolds project configuration (pyproject.toml and .mise.toml) and exposes common commands run through uv and mise. It wires ruff for linting/formatting, basedpyright for strict type checking, and pytest for testing, and it maps tasks to mise so you can run composite checks. Dependency management, locking, and workspace commands are handled through uv to keep environments consistent and reproducible.

When to use it

• Initializing a new Python project with modern tooling and locked dependencies
• Standardizing linting, formatting, and type checking across a team
• Setting up continuous quality checks (pre-commit, CI pipelines, or mise tasks)
• Running fast local test and coverage reports with pytest
• Pinning Python versions and project tasks using mise for consistent developer environments

Best practices

• Keep configuration in pyproject.toml to centralize tool settings
• Pin the Python runtime with .mise.toml to avoid “works on my machine” issues
• Enable strict typeCheckingMode in basedpyright for earlier bug detection
• Use ruff to replace multiple linters/formatters for a single fast toolchain
• Run mise run check (lint, format, typecheck, test) before committing code

Example use cases

• Create a minimal project: uv init, add runtime deps and dev tools, then uv sync and uv lock for reproducible installs
• Automate developer checks: define lint/format/typecheck/test tasks in .mise.toml and run mise run check locally or in CI
• Enforce types: add basedpyright to dev dependencies and run uv run basedpyright for strict type validation
• Fast formatting and linting: run uv run ruff format . and uv run ruff check --fix . as part of pre-commit or CI
• Run tests and coverage: uv run pytest --cov=src --cov-report=html to generate coverage reports for PRs