К основному содержанию
скилл CX Codex

uv-advanced-dependencies — скилл для Claude Code: Git-зависимости

Скилл uv-advanced-dependencies для работы с нестандартными источниками зависимостей в uv: репозиториями на GitHub, локальными пакетами в режиме редактирования, приватными индексами.

MIT 332 установок ★ 60 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add laurigates/claude-plugins --skill uv-advanced-dependencies -a claude-code
Открыть на GitHub

Что делает uv-advanced-dependencies

Скилл даёт полный набор команд для git-зависимостей (ветки, теги, коммиты), локальных путей, редактируемых установок и групп зависимостей. Включает примеры конфигурации в pyproject.toml: как указать источник через [tool.uv.sources], как организовать зависимости в [dependency-groups], как работать с дополнительными индексами и токенами доступа.

Внутри — команды bash для быстрого добавления зависимостей (uv add git+https://...), паттерны для монорепозиториев с локальными пакетами, стратегии разрешения версий и примеры приватных индексов с переменными окружения. Скилл помогает, когда стандартные PyPI-пакеты недостаточны и нужна гибкость источников.

Какие задачи решает

  • Добавить зависимость из Git-репозитория с конкретной веткой или тегом
  • Настроить локальный пакет в режиме редактирования для разработки
  • Организовать зависимости по группам (dev, test, docs) в одном проекте
  • Подключить приватный индекс пакетов с аутентификацией
  • Смешать источники: PyPI, Git, локальные пакеты в одном pyproject.toml

Примеры запросов агенту

  • Добавь зависимость из репозитория: uv add git+https://github.com/pallets/flask@main
  • Подключи локальный пакет для разработки: uv add --editable ../my-local-package
  • Установи все группы зависимостей: uv sync --all-groups

Как установить uv-advanced-dependencies

1Через Skills CLI (Vercel)

npx skills add laurigates/claude-plugins --skill uv-advanced-dependencies -a claude-code

2Вручную: положить файлы

~/.claude/skills/uv-advanced-dependencies/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/uv-advanced-dependencies/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об uv-advanced-dependencies

Как установить uv-advanced-dependencies в Claude Code?

Выполни npx skills add laurigates/claude-plugins --skill uv-advanced-dependencies -a claude-code, затем открой ~/.claude/skills/uv-advanced-dependencies/SKILL.md.

Что делает uv-advanced-dependencies?

Предоставляет команды и конфиги для работы с Git-зависимостями, локальными пакетами, приватными индексами, группами и дополнительными возможностями uv сверх базового управления PyPI-пакетами.

Когда использовать этот скилл вместо uv-project-management?

Используй uv-advanced-dependencies, когда нужны git+https-ссылки, editable-установки или кастомные индексы. Для простого добавления PyPI-пакетов достаточно uv-project-management.

Исходный текст

SKILL.md · MIT
---
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://[email protected]/user/[email protected]

# Specific branch, tag, or commit
uv add git+https://github.com/user/repo@feature-branch
uv add git+https://github.com/user/[email protected]
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

# constraints.txt example:
# numpy<2.0
# pandas==2.0.3
```

### Custom Indexes

```toml
[tool.uv]
index-url = "https://pypi.org/simple"
extra-index-url = [
    "https://custom.pypi.org/simple",
]
```

## Git Dependencies in pyproject.toml

```toml
[project]
dependencies = [
    "my-package",
]

[tool.uv.sources]
my-package = { git = "https://github.com/user/my-package" }

# With branch
my-package = { git = "https://github.com/user/my-package", branch = "main" }

# With tag
my-package = { git = "https://github.com/user/my-package", tag = "v1.0.0" }

# With commit
my-package = { git = "https://github.com/user/my-package", rev = "abc123" }
```

## Path Dependencies in pyproject.toml

```toml
[project]
dependencies = [
    "my-local-package",
]

[tool.uv.sources]
my-local-package = { path = "../my-local-package" }

# Editable (default for paths)
my-local-package = { path = "../my-local-package", editable = true }

# Non-editable
my-local-package = { path = "../my-local-package", editable = false }
```

## Dependency Groups

```toml
[dependency-groups]
dev = [
    "pytest>=7.0",
    "pytest-cov>=4.0",
    "ruff>=0.1.0",
]
docs = [
    "mkdocs-material>=9.0",
    "mkdocstrings[python]>=0.24",
]
test = [
    "pytest-asyncio>=0.21",
    "pytest-mock>=3.12",
]
```

## URL Dependencies

```bash
# Add from direct URL
uv add https://files.pythonhosted.org/packages/.../requests-2.31.0.tar.gz

# In pyproject.toml
[tool.uv.sources]
my-package = { url = "https://example.com/my-package-1.0.tar.gz" }
```

## Private Package Indexes

```toml
[tool.uv]
# Primary index
index-url = "https://pypi.org/simple"

# Additional indexes
extra-index-url = [
    "https://${PRIVATE_TOKEN}@private.pypi.org/simple",
]

# Find links
find-links = [
    "https://download.pytorch.org/whl/cu118",
]
```

```bash
# Set token via environment
export PRIVATE_TOKEN="secret"
uv sync
```

## Build Dependencies

```toml
[build-system]
requires = [
    "setuptools>=68",
    "wheel",
    "Cython>=3.0",
]
build-backend = "setuptools.build_meta"
```

## Common Patterns

### Development from Local Checkout

```bash
# Clone dependency
git clone https://github.com/user/lib.git ../lib

# Add as editable
cd my-project
uv add --editable ../lib
```

### Monorepo Path Dependencies

```toml
[tool.uv.sources]
my-core = { path = "packages/core" }
my-utils = { path = "packages/utils" }
```

### Mixed Sources

```toml
[project]
dependencies = [
    "fastapi",          # PyPI
    "my-lib",           # Git
    "my-local",         # Path
]

[tool.uv.sources]
my-lib = { git = "https://github.com/user/my-lib" }
my-local = { path = "../my-local" }
```

## Resolution Strategies

```toml
[tool.uv]
# Highest compatible (default)
resolution = "highest"

# Lowest compatible
resolution = "lowest"

# Lowest direct, highest transitive
resolution = "lowest-direct"
```

## See Also

- `uv-project-management` - Basic dependency management
- `uv-workspaces` - Workspace member dependencies
- `python-packaging` - Build system configuration

## References

- Official docs: https://docs.astral.sh/uv/concepts/dependencies/
- Detailed guide: See REFERENCE.md in this skill directory

© laurigates · MIT · laurigates/claude-plugins

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
Poetry Packaging pluginagentmarketplace Скилл Poetry Packaging обучает агента собирать пакеты Python через Poetry, настраивать pyproject.toml и публиковать релизы в PyPI. CX Codex +1 132установок python-packaging Seth Hobson Скилл python-packaging помогает собрать Python-библиотеку или CLI-инструмент в устанавливаемый пакет и подготовить публикацию в PyPI. Подходит для настройки структуры проекта. CX Codex +1 12 915установок release Eigenwise Скилл release для Claude Code ведёт выпуск atomic-agents: поднимает версию, собирает пакет через uv, отправляет в PyPI и оформляет релиз на GitHub. CX Codex +1 ★ 6 344звёзд репо python-pypi-package-builder официальный github Скилл python-pypi-package-builder для GitHub Copilot собирает и проверяет Python-пакет, настраивает его версию и публикует в PyPI. Работает с библиотеками, SDK, CLI и плагинами. CX Codex +1 943установок uv harperreed Помогает настроить Python-проекты через uv: зависимости, виртуальные окружения, скрипты PEP 723, CI и сборку Docker. CX Codex +1 ★ 339звёзд репо Python Packaging taste f Промпт Python Packaging taste для ChatGPT и Claude.ai, который задаёт агенту правила упаковки Python-проектов: pyproject.toml, src/, uv, Ruff. Направляет модель давать советы по одному стилю вместо разных подходов. GP ChatGPT ★ 178 201звёзд репо

Из того же набора27

Весь набор →
uv-workspaces Скилл uv-workspaces для работы с многопакетными Python-проектами на uv: настройка workspace, общий lockfile, зависимости между пакетами. CX Codex +1 356установок uv-run Скилл uv-run инструктирует агента запускать Python-скрипты через менеджер uv без ручной активации виртуального окружения и оформлять зависимости прямо внутри файла. CX Codex +1 342установок python-packaging Скилл python-packaging помогает собрать пакеты wheel и sdist через uv, а затем выгрузить их в PyPI или Test PyPI. Пригодится при настройке pyproject.toml и консольных утилит. CX Codex +1 336установок uv-python-versions Скилл uv-python-versions помогает управлять версиями CPython и PyPy через uv: устанавливать интерпретаторы, закреплять версию проекта и переключаться между ними. CX Codex +1 332установок uv-tool-management Скилл uv-tool-management для Claude Code управляет глобальными Python CLI-утилитами через uv и запускает их без установки. Заменяет pipx и работает с ruff и pytest. CX Codex +1 328установок imagemagick-conversion Скилл imagemagick-conversion для Claude Code пакетно преобразует, масштабирует и оптимизирует изображения через ImageMagick в командной строке. Конвертирует форматы, создаёт миниатюры и обрабатывает сотни файлов за раз. CX Codex +1 260установок jq-json-processing Скилл jq-json-processing для парсинга, фильтрации и трансформации JSON через jq. Извлекает поля, фильтрует массивы, перестраивает объекты и валидирует синтаксис. CX Codex +1 245установок python-development Скилл python-development даёт агенту идиомы Python 3.10+: подсказки типов, match, asyncio, отладку. Полезен, когда правите библиотечный код или разбираете чужой. CX Codex +1 192установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой