# Uv Ruff Only Tooling Migration

> Migrate a Python repo from Poetry/Black to UV + Ruff-only (CI, pre-commit, pyproject, docs). Use when this capability is needed.

- Skill: `tomevault-io/uv-ruff-only-tooling-migration` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/uv-ruff-only-tooling-migration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/uv-ruff-only-tooling-migration/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/uv-ruff-only-tooling-migration

---

<!-- BEGIN:compound:skill-managed -->
# When To Use
- Repo has `uv.lock` (or wants UV).
- User wants no Poetry and/or no Black.

# Steps
- Remove Poetry artifacts
  - Delete `poetry.lock`.
  - Remove Poetry commands/docs references.
- Make `pyproject.toml` UV-native
  - Ensure PEP 621 `[project]` is source of truth.
  - Prefer `[dependency-groups]` for `dev`/`docs` tool deps.
  - Add missing runtime deps surfaced by imports/tests.
  - Run `uv lock` to regenerate `uv.lock`.
- Pre-commit
  - Remove Black hook.
  - Add `ruff-format` and `ruff` hooks.
  - Ensure hooks run via the repo’s standard workflow.
- CI
  - Replace Black check with `uv run ruff format --check`.
  - Lint with `uv run ruff check`.
  - Use `uv sync --dev` and `uv pip install -e .`.
  - If needed, temporarily run a stable smoke suite while fixing failing tests.
- Docs/agent guidance
  - Update `AGENTS.md`, `README.md`, and contrib/dev docs to reference UV + Ruff only.

# Verify
- `uv sync --dev`
- `uv pip install -e .`
- `uv run ruff format --check src tests`
- `uv run ruff check src tests`
- `uv run pytest` (or smoke suite if full is broken)
<!-- END:compound:skill-managed -->

## Manual notes

_This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here._

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/z3z1ma) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->