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)

Manual notes

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