modern-python

Installation
Summary

Modern Python project setup with uv, ruff, and ty for Python 3.11+.

  • Replaces pip, Poetry, black, flake8, mypy, and pre-commit with faster, simpler alternatives from the Astral team
  • Covers new project creation, dependency management via uv add/uv remove, and linting/formatting/type-checking workflows
  • Includes migration paths from legacy tooling (requirements.txt, setup.py, flake8+black+isort, mypy/pyright)
  • Provides decision tree for single-file scripts (PEP 723), simple projects, and distributable packages, plus security tool integration (pip-audit, detect-secrets, shellcheck)
SKILL.md

Modern Python

Guide for modern Python tooling and best practices, based on trailofbits/cookiecutter-python.

When to Use This Skill

  • Creating a new Python project or package
  • Setting up pyproject.toml configuration
  • Configuring development tools (linting, formatting, testing)
  • Writing Python scripts with external dependencies
  • Migrating from legacy tools (when user requests it)

When NOT to Use This Skill

  • User wants to keep legacy tooling: Respect existing workflows if explicitly requested
  • Python < 3.11 required: These tools target modern Python
  • Non-Python projects: Mixed codebases where Python isn't primary

Anti-Patterns to Avoid

Related skills
Installs
3.7K
GitHub Stars
5.1K
First Seen
Jan 26, 2026