Agent skill
python-env
Fast Python environment management with uv (10-100x faster than pip). Triggers on: uv, venv, pip, pyproject, python environment, install package, dependencies.
Install this agent skill to your Project
npx add-skill https://github.com/0xDarkMatter/claude-mods/tree/main/skills/python-env
SKILL.md
Python Environment
Fast Python environment management with uv.
Quick Commands
| Task | Command |
|---|---|
| Create venv | uv venv |
| Install package | uv pip install requests |
| Install from requirements | uv pip install -r requirements.txt |
| Run script | uv run python script.py |
| Show installed | uv pip list |
Virtual Environment
# Create venv (instant)
uv venv
# Create with specific Python
uv venv --python 3.11
# Activate (or use uv run)
source .venv/bin/activate # Unix
.venv\Scripts\activate # Windows
Package Installation
# Single package
uv pip install requests
# Multiple packages
uv pip install flask sqlalchemy pytest
# With extras
uv pip install "fastapi[all]"
# Version constraints
uv pip install "django>=4.0,<5.0"
# Uninstall
uv pip uninstall requests
Minimal pyproject.toml
[project]
name = "my-project"
version = "0.1.0"
requires-python = ">=3.10"
dependencies = [
"httpx>=0.25",
"pydantic>=2.0",
]
[project.optional-dependencies]
dev = [
"pytest>=7.0",
"ruff>=0.1",
]
Project Setup Checklist
mkdir my-project && cd my-project
uv venv
# Create pyproject.toml
uv pip install -e ".[dev]"
uv pip list
Troubleshooting
| Issue | Solution |
|---|---|
| "No Python found" | uv python install 3.11 |
| Wrong Python version | uv venv --python 3.11 |
| Conflicting deps | uv pip compile --resolver=backtracking |
| Cache issues | uv cache clean |
When to Use
- Always use uv over pip for speed
- Creating virtual environments
- Installing packages
- Managing dependencies
- Running scripts in project context
Additional Resources
For detailed patterns, load:
./references/pyproject-patterns.md- Full pyproject.toml examples, tool configs./references/dependency-management.md- Lock files, workspaces, private packages./references/publishing.md- PyPI publishing, versioning, CI/CD
See Also
This is a foundation skill with no prerequisites.
Build on this skill:
python-typing-ops- Type hints for projectspython-pytest-ops- Testing infrastructurepython-fastapi-ops- Web API development
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
log-ops
Log analysis and JSONL processing - structured extraction, cross-log correlation, timeline reconstruction, pattern search
data-processing
Process JSON with jq and YAML/TOML with yq. Filter, transform, query structured data efficiently. Triggers on: parse JSON, extract from YAML, query config, Docker Compose, K8s manifests, GitHub Actions workflows, package.json, filter data.
testgen
Generate tests with expert routing, framework detection, and auto-TaskCreate. Triggers on: generate tests, write tests, testgen, create test file, add test coverage.
vue-ops
Vue 3 development patterns, Composition API, Pinia state management, Vue Router, and Nuxt 3. Use for: vue, vuejs, composition api, pinia, vue router, nuxt, nuxt3, script setup, composable, reactive, defineProps, defineEmits, defineModel, v-model, provide inject, vue3.
python-cli-ops
CLI application patterns for Python. Triggers on: cli, command line, typer, click, argparse, terminal, rich, console, terminal ui.
claude-code-debug
Troubleshoot Claude Code extensions and behavior. Triggers on: debug, troubleshoot, not working, skill not loading, hook not running, agent not found.
Didn't find tool you were looking for?