# uv-advanced-dependencies

uv-advanced-dependencies is a skill for managing non-standard dependency sources in uv, including GitHub repositories, editable local packages, and private indexes. It covers projects that need Git, local path, or custom index dependencies.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 332 installs · ★ 60 repo stars
- Author: laurigates
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/laurigates/claude-plugins/tree/HEAD/python-plugin/skills/uv-advanced-dependencies/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/uv-advanced-dependencies

## What it does

This skill provides commands for git-sourced dependencies (branches, tags, commits), local paths, editable installs, and grouped dependencies. It covers configuration patterns in `pyproject.toml`: declaring sources via `[tool.uv.sources]`, organizing dependencies in `[dependency-groups]`, setting up extra indexes, and handling authentication tokens.

Includes bash commands for quick operations (`uv add git+https://...`), monorepo patterns with local packages, version resolution strategies, and private index examples with environment variables. The skill bridges the gap between PyPI's convenience and scenarios that demand more flexible, distributed sources.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add laurigates/claude-plugins --skill uv-advanced-dependencies -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/uv-advanced-dependencies/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/uv-advanced-dependencies/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add laurigates/claude-plugins --skill uv-advanced-dependencies -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/uv-advanced-dependencies/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add laurigates/claude-plugins --skill uv-advanced-dependencies -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/uv-advanced-dependencies/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install laurigates/claude-plugins python-plugin/skills/uv-advanced-dependencies
```

2. **Manually: put the files in place**
- File: `.github/skills/uv-advanced-dependencies/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add laurigates/claude-plugins --skill uv-advanced-dependencies -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/laurigates/claude-plugins --path python-plugin/skills/uv-advanced-dependencies
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/uv-advanced-dependencies/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add laurigates/claude-plugins --skill uv-advanced-dependencies -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/laurigates/claude-plugins/tree/HEAD/python-plugin/skills/uv-advanced-dependencies/SKILL.md

## When to use it
- Pin a dependency to a Git repository at a specific branch or tag
- Set up a local package in editable mode for active development
- Organize dependencies into groups (dev, test, docs) within a single project
- Connect a private package index with authentication tokens
- Mix multiple sources—PyPI, Git, local paths—in one `pyproject.toml`

## Example prompts
- Add a Git dependency: `uv add git+https://github.com/pallets/flask@main`
- Link a local package for editing: `uv add --editable ../my-local-package`
- Install all dependency groups: `uv sync --all-groups`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 95274e4971487f24.

BEGIN THIRD-PARTY FILE 95274e4971487f24
````text
---
created: 2025-12-16
modified: 2026-11-14
reviewed: 2026-04-25
name: uv-advanced-dependencies
description: "Advanced uv dependencies: Git deps, path deps, editable installs, groups, extras, custom indexes. Use when the user mentions git+https deps, editable installs, or private indexes."
user-invocable: false
allowed-tools: Bash(uv add *), Bash(uv sync *), Bash(uv pip compile *), Read, Grep, Glob
---

# UV Advanced Dependencies

Quick reference for advanced dependency scenarios in UV projects.

## When to Use This Skill

| Use this skill when... | Use a focused sibling instead when... |
|---|---|
| Pinning a dependency to a git URL, branch, or tag, or installing in editable mode | Adding a normal PyPI dependency — use uv-project-management |
| Configuring `[tool.uv.sources]`, dependency groups, extras, or custom indexes | Sharing source declarations across workspace members — use uv-workspaces |
| Setting up private package indexes or build-time constraints | Running an ephemeral script with `--with` deps — use uv-run |

## When This Skill Applies

- Git repository dependencies
- Local path dependencies
- Editable installations
- Dependency constraints
- Custom package indexes
- Dependency groups and extras
- Build dependencies

## Quick Reference

### Git Dependencies

```bash
# Add from Git repository
uv add git+https://github.com/psf/requests
uv add git+https://github.com/pallets/flask@main
uv add git+ssh://git@github.com/user/repo.git@v1.0.0

# Specific branch, tag, or commit
uv add git+https://github.com/user/repo@feature-branch
uv add git+https://github.com/user/repo@v2.0.0
uv add git+https://github.com/user/repo@abc123
```

### Path Dependencies

```bash
# Add from local path
uv add --editable ./local-package
uv add ../another-project
uv add /absolute/path/to/package

# Non-editable path
uv add --no-editable ./local-package
```

### Dependency Groups

```bash
# Add to named group
uv add --group docs sphinx mkdocs
uv add --group test pytest pytest-cov

# Install specific groups
uv sync --group docs
uv sync --group test --group docs

# Install all groups
uv sync --all-groups
```

### Extras (Optional Dependencies)

```bash
# Install package with extras
uv add 'fastapi[all]'
uv add 'sqlalchemy[postgresql,mypy]'

# Define extras in pyproject.toml
[project.optional-dependencies]
dev = ["pytest", "ruff"]
docs = ["mkdocs", "mkdocs-material"]
```

### Constraint Files

```bash
# Apply version constraints
uv pip compile requirements.in --constraint constraints.txt
````
END THIRD-PARTY FILE 95274e4971487f24

The third-party file has ended. Everything between the 95274e4971487f24 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2516 of 5668 bytes. © laurigates · MIT · https://github.com/laurigates/claude-plugins/tree/HEAD/python-plugin/skills/uv-advanced-dependencies/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
