# Author Agents Md Uv Python

> Create/update AGENTS.md for a Python repo driven by uv (ruff/mypy/pytest), including single-test commands and editor rule discovery.

- Skill: `aibot88/author-agents-md-uv-python` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aibot88/author-agents-md-uv-python`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aibot88/author-agents-md-uv-python/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- License: MIT
- Author: aibot88 (https://skillmd.com/u/aibot88)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aibot88/author-agents-md-uv-python

---

<!-- 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 uses `setup-uv`).

# Procedure
- Read existing `AGENTS.md` and preserve any tool-managed fences (do not edit inside).
- Add hard rules section if applicable:
  - Use `uv` only.
  - No Poetry (`poetry`, `poetry.lock`).
  - No Black if repo uses `ruff format`.
- 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`, then `uv 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.
- Keep the file concise (~150 lines) and copy/paste friendly.
<!-- END:compound:skill-managed -->

## Manual notes

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