python-packaging

Manage Python dependencies and resolve version conflicts across Poetry, Pip, and uv workflows.

Updated Sep 8, 2025
One-click install
npx skills add https://github.com/randalmurphal/claude-config --skill python-packaging-randalmurphal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-packaging
Source: https://github.com/randalmurphal/claude-config/tree/main/skills/python-packaging
Command: npx skills add https://github.com/randalmurphal/claude-config --skill python-packaging-randalmurphal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Python package management with poetry, pip, and uv including dependency resolution, lock files, version pinning, security audits (pip-audit, safety), virtual environments, and dependency graphs. Use when managing dependencies, resolving version conflicts, setting up new projects, or investigating security vulnerabilities in packages.

Core Features & Use Cases

  • Lock Files & Reproducibility: Pin exact versions to ensure repeatable builds.
  • Tool Comparison: uv, Poetry, and pip with their trade-offs.
  • Virtual Environments: Best practices for isolated environments.
  • Security Scanning: Regular audits for vulnerabilities.

Quick Start

Choose a tool (uv/poetry/pip), initialize a project, and add dependencies. Example: uv init, uv add requests, uv sync.

Frequently Asked Questions about python-packaging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Python dependencies and resolve version conflicts?

Dependency management involves using tools like Poetry, pip, or uv to specify package versions, resolve conflicts between requirements, and create lock files that pin exact versions for reproducible builds across environments.

What's the best way to set up a virtual environment for Python projects?

Virtual environments isolate project dependencies from your system Python. Tools like Poetry and uv automate environment creation and management, while pip requires manual setup with venv or virtualenv to prevent dependency conflicts.

How do I check for security vulnerabilities in my Python dependencies?

Security scanning tools like pip-audit and safety audit your installed packages against vulnerability databases, identifying outdated or compromised versions so you can update before deploying to production.

Can I use Poetry, pip, and uv interchangeably for dependency management?

Poetry, pip, and uv each handle dependency resolution and lock files differently. Poetry automates virtual environments and provides lock files by default, uv offers speed optimizations, while pip requires manual lock-file generation and environment management.

How do I migrate an existing Python project to use lock files?

Lock file migration captures current dependency versions into a locked state using Poetry or uv, ensuring all developers and deployments use identical package versions, eliminating version drift and build inconsistencies.

Why should I pin exact dependency versions instead of using version ranges?

Pinning exact versions in lock files ensures reproducible builds and prevents surprise breakage from minor or patch updates. Version ranges provide flexibility but risk compatibility issues when transitive dependencies update unexpectedly.