# Uv

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-jskherman-engg-skills-uv`
- **Verified:** Pending review
- **Seller:** [jskherman](https://agentstack.voostack.com/s/jskherman)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [jskherman](https://github.com/jskherman)
- **Source:** https://github.com/jskherman/engg-skills/tree/main/skills/uv

## Install

```sh
agentstack add skill-jskherman-engg-skills-uv
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# uv (Python runner)

## Overview

Every other skill in this repository runs its scripts via `uv run`
(PEP-723 inline dependency declaration). This skill is a one-page check:
"is `uv` on PATH, and if not, how do you install it?"

## When to Use

- Setting up the environment for the first time.
- A skill invocation has failed with `uv: command not found`.

## Don't use for

- Any engineering calculation.
- Authoring a new skill (use `engineering-skill-creator` instead).

## Setup

If `uv` is missing, install it from https://docs.astral.sh/uv/ . The
common path on Linux/macOS:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

On Windows (PowerShell):

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

Then verify:

```bash
uv --version
```

## Conventions

- Every script in this repository is invoked as
  `uv run /scripts/.py  --  --output /tmp/.json`.
- The script header declares dependencies inline (PEP-723); `uv run` will
  install them the first time and cache for subsequent runs.
- Stdout is reserved for a single success message; results live in the
  JSON file at `--output`.

## Procedure

1. Read this SKILL.md and any referenced files needed for the task.
2. Use scripts from `scripts/` when a deterministic calculation or check is available.
3. Preserve stated assumptions, warnings, and scope limits in the final answer.

## Pitfalls

- Trying to `python` a script directly rather than `uv run`; the script
  header won't be respected.
- Running scripts from a different working directory than the skill folder
  — works, but path-based imports resolve `engg_skills_common` from the sibling
  `skills/engg-skills-common` folder, which is robust.

## Verification

- Run `uv --version` and confirm it prints a version.
- Run a representative skill script with `uv run ... --output ` and confirm the JSON output file is created.

## References

- https://docs.astral.sh/uv/
- https://github.com/astral-sh/uv

## Anti-Patterns

- Installing `uv` globally with `sudo`; let the install script handle it.
- Pinning `uv` versions in skill scripts; the PEP-723 dependencies pin the
  Python deps, and `uv` itself should be free to update.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jskherman](https://github.com/jskherman)
- **Source:** [jskherman/engg-skills](https://github.com/jskherman/engg-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jskherman-engg-skills-uv
- Seller: https://agentstack.voostack.com/s/jskherman
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.