venv-manager

The venv-manager skill provides an autonomous, agentic workflow for the end-to-end management of Python virtual environments. Designed for developers and AI agents operating within technical project folders, it ensures that project dependencies remain isolated, reproducible, and verifiable. By implementing standardized procedures for environment creation, package installation, and state validation, the skill reduces environment drift and prevents common dependency conflicts across development and production environments. It is intended for software engineers and DevOps practitioners who require a robust, repeatable system for local Python environment orchestration.

• Automatically detects and verifies existing Python interpreters and versions before initiating creation.

• Supports standard creation, version-specific environments (e.g., python3.11), and site-package access configurations.

• Handles dependency installation workflows including requirements.txt, pyproject.toml, and development-specific dependency files.

• Performs environment health checks including listing packages, running pip check, and exporting reproducible dependency locks via pip freeze.

• Integrates a structured recovery protocol to diagnose and resolve failures during environment setup or activation.

• Maintains audit trails through checkpointing, recording python versions, pip freeze snapshots, and validation statuses in local directories.

• Requires a writable directory and Python 3 interpreter availability to function.

• Strictly adheres to ground-truth checks to prevent accidental deletion of existing virtual environments.

• Designed for command-line execution (bash/zsh) and provides standardized activation paths for cross-platform compatibility.

• Best practices include consistent use of venv/ or .venv/ naming conventions and proactive exclusion of environment directories from version control via .gitignore.

• Use this skill when transitioning into a new project, setting up local development workspaces, or performing automated environment reconstruction tasks. Always verify Python version prerequisites to ensure compatibility before initiating environment generation.