name: author-agents-md-uv-python description: Create/update AGENTS.md for a Python repo driven by uv (ruff/mypy/pytest), including single-test commands and editor rule discovery. license: MIT compatibility: opencode,claude metadata: created_at: "2026-01-29T05:13:10.069Z" updated_at: "2026-01-29T05:13:10.069Z" version: "1"
<!-- BEGIN:compound:skill-managed -->Purpose
Create or improve AGENTS.md for a Python repo that uses uv.
When To Use
- User asks to create/update
AGENTS.md. - Repo uses
uv(e.g.,uv.lock, CI usessetup-uv).
Procedure
- Read existing
AGENTS.mdand preserve any tool-managed fences (do not edit inside). - Add hard rules section if applicable:
- Use
uvonly. - No Poetry (
poetry,poetry.lock). - No Black if repo uses
ruff format.
- Use
- Discover editor rules:
.cursorrules,.cursor/rules/**,.github/copilot-instructions.md.
- Discover commands from
pyproject.toml,.github/workflows/**,README.md,docs/**,.pre-commit-config.yaml. - Write UV-first commands:
- Setup:
uv sync --dev, thenuv pip install -e .. - Format:
uv run ruff format .... - Lint:
uv run ruff check ...(+--fix). - Typecheck:
uv run mypy .... - Tests: include single file + single node id + markers.
- Integration: include docker-compose steps and any helper scripts.
- Docs:
uv run sphinx-build ...if present.
- Setup:
- Keep the file concise (~150 lines) and copy/paste friendly.
Manual notes
This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.