SkillAgentSearch skills...

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 / Use

npx skills add aiskillstore/marketplace --skill python-env

Installs into whichever agent you are using.

About this skill
๐Ÿ“„

SKILL.md

Installable skill definition

Quality Score

87/100

Category

Automation

Supported Platforms

Claude Code

Our assessment of python-env

python-env scores 87/100 on our quality scale, 1722nd of 2,768 Automation skills we index.

Its SKILL.md is 5.2 KB long, well organised into 23 sections with 7 code examples: a solid amount of guidance for an agent.

It has 428 GitHub stars, a meaningful sign that others use it.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
11/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so python-env is actively maintained.
  • Our last check on 2026-11-02 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit โ€” read the skill file before letting an agent act on it.

Safety scan

Review

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review judged it risky: The skill file's metadata includes an install instruction: `curl -LsSf https://astral.sh/uv/install.sh | sh`, which tells the agent to pipe a remote script into a shell.

  • noteInstalls by piping a downloaded script into a shellline 5
    compatibility: "Requires uv CLI tool. Install: curl -LsSf https://astral.sh/uv/install.sh | sh"

AI review: risky

  • The skill file's metadata includes an install instruction: `curl -LsSf https://astral.sh/uv/install.sh | sh`, which tells the agent to pipe a remote script into a shell.
  • Because this is a SKILL.md file (instructions the agent follows), that command counts as an agent-directed action, not merely human README documentation.
  • The rest of the file is legitimate uv usage guidance, but the remote shell-pipe install weakens safeguards by executing unverified code from the network.

AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk โ€” read a skill before letting an agent act on it.

python-env compared with similar skills

All 4 of these similar skills score higher than python-env; compare them before choosing.

SkillScoreStarsUpdatedFormat
python-env (this skill)by aiskillstore8742855d agoSKILL.md
Agent-Reachby Panniantong100113.0k10d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10080.1ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10040.1k9d agoCLAUDE.md

Frequently asked questions

How do I install python-env?
Run npx skills add aiskillstore/marketplace --skill python-env. The install tabs above show the steps for each supported agent.
Which AI agents does python-env work with?
It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
Is python-env safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (1 minor note below). An AI review judged it risky: The skill file's metadata includes an install instruction: curl -LsSf https://astral.sh/uv/install.sh | sh, which tells the agent to pipe a remote script into a shell. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is python-env still maintained?
The repository was last updated about 2 months ago, so python-env is actively maintained.

name: python-env description: "Fast Python environment management with uv (10-100x faster than pip). Triggers on: uv, venv, pip, pyproject, python environment, install package, dependencies." license: MIT compatibility: "Requires uv CLI tool. Install: curl -LsSf https://astral.sh/uv/install.sh | sh" allowed-tools: "Bash" metadata: author: claude-mods

Python Environment

Fast Python environment management with uv. Prefer the uv project workflow (uv add / uv sync / uv run) over the uv pip compatibility layer โ€” it manages pyproject.toml + a lockfile for you and is reproducible.

Quick Commands

| Task | Command | |------|---------| | Start a project | uv init <name> (app) ยท uv init --package <name> (installable, src/ layout) | | Add dependency | uv add httpx | | Add dev dependency | uv add --dev pytest ruff | | Remove dependency | uv remove httpx | | Sync env from lockfile | uv sync | | Run in project env | uv run pytest | | Update lockfile | uv lock | | Install a CLI tool | uv tool install ruff ยท one-shot: uvx ruff | | Install a Python | uv python install 3.12 |

Start a Project

# Application (flat layout, no package build)
uv init myapp

# Installable package (src/ layout โ€” separate tests/ that import by name)
uv init --package wordtools
# โ†’ src/wordtools/__init__.py, pyproject.toml with build-system

uv init creates pyproject.toml, pins a Python version, and prepares the project for uv add / uv sync. The --package (src) layout is preferred for anything with a test suite or that you intend to ship.

Manage Dependencies

# Add runtime deps (writes to [project.dependencies] + updates the lockfile)
uv add "httpx>=0.25" pydantic

# Add dev-only deps (writes to the dev dependency-group)
uv add --dev pytest ruff mypy

# Add with extras
uv add "fastapi[standard]"

# Remove
uv remove httpx

# Install everything from pyproject + uv.lock into .venv (reproducible)
uv sync

# Refresh the lockfile (e.g. after manual pyproject edits)
uv lock

uv creates and manages .venv automatically โ€” you rarely activate it; just prefix commands with uv run.

Run Code

uv run python script.py     # run a script in the project env
uv run pytest               # run a tool from the dev group
uv run -- ruff check .      # `--` ends uv flag parsing

Never call bare python / pytest / ruff in a uv project โ€” they may resolve to a different interpreter. Always uv run.

CLI Tools (global, not project deps)

uv tool install ruff        # persistent, isolated, on PATH
uv tool upgrade ruff
uvx ruff check .            # ephemeral one-shot run, nothing installed

Use uv tool / uvx for developer CLIs (ruff, pre-commit, httpie). Use uv add only for things your code imports.

Python Versions

uv python install 3.12      # download a managed interpreter
uv python list              # show available + installed
uv init --python 3.12 app   # pin a project to a version

Check python.org for the current stable (3.14 as of 2026-07; recent releases add opt-in free-threading and a JIT). 3.11+ is a sensible floor for new projects (TaskGroup, Self, faster interpreter).

Minimal pyproject.toml

[project]
name = "my-project"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
    "httpx>=0.25",
    "pydantic>=2.0",
]

# Dev deps live here; `uv add --dev <pkg>` manages this group.
[dependency-groups]
dev = [
    "pytest>=8.0",
    "ruff>=0.4",
    "mypy>=1.10",
]

Compatibility Layer (uv pip) โ€” last resort

uv pip mirrors pip's interface for environments uv doesn't manage (a hand-made venv, a legacy requirements.txt, CI that isn't uv-native). It does not update pyproject.toml or the lockfile โ€” prefer uv add / uv sync whenever you control the project.

uv venv                              # bare venv (no project)
uv pip install -r requirements.txt   # legacy requirements file
uv pip install -e .                  # editable install into an unmanaged venv
uv pip compile requirements.in -o requirements.txt   # pin a requirements.txt

Troubleshooting

| Issue | Solution | |-------|----------| | "No Python found" | uv python install 3.12 | | Pin project Python | uv init --python 3.12 or edit requires-python | | Lock/resolve conflict | uv lock --resolution=lowest-direct to probe, then loosen bounds | | Stale env after pull | uv sync | | Cache issues | uv cache clean |

When to Use

  • Always use uv over pip โ€” 10-100x faster
  • uv add / uv remove / uv sync for project dependencies (not uv pip install)
  • uv run to execute anything inside the project env
  • uv tool install / uvx for standalone developer CLIs
  • uv pip only for environments uv doesn't manage

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 projects
  • python-pytest-ops - Testing infrastructure
  • python-fastapi-ops - Web API development

Related Skills

View on GitHub
GitHub Stars428
CategoryAutomation
Updated1mo ago
Forks45

Languages

Python

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit โ€” see the Safety scan above for what the skill file itself contains.

1 medium
python-env โ€” Claude Code Skill: Install & Safety Check | SkillAgent