name: python-egg-info-hygiene description: Handle noisy git diffs from src/*.egg-info generated by editable installs (uv) and decide whether to commit or ignore. license: MIT compatibility: opencode,claude metadata: created_at: "2026-01-30T00:40:06.910Z" updated_at: "2026-01-30T00:40:06.910Z" version: "1"
Purpose
Reduce churn from auto-generated src/*.egg-info changes (ex: PKG-INFO, requires.txt).
When To Use
git status/ diff shows onlysrc/*.egg-info/**modifications.- The churn appears after
uv sync,uv pip install -e ., or packaging metadata updates.
Checklist
- Confirm scope: changes are limited to
src/*.egg-info/**. - Treat as generated by default:
- Do not commit unless the repo intentionally tracks
*.egg-info. - Call out that editable installs can rewrite these files.
- Do not commit unless the repo intentionally tracks
- If a commit is requested anyway:
- Verify the repo convention (historical commits include
src/*.egg-info/**). - Ensure the underlying source of truth (ex:
pyproject.toml) was actually updated. - Prefer committing the source-of-truth change over committing generated metadata.
- Verify the repo convention (historical commits include
- If the user wants to clean the workspace (local-only):
- Recommend removing
src/*.egg-infoand re-runninguv pip install -e .to regenerate.
- Recommend removing
Notes
*.egg-infois typically build/install output; committing it often creates noisy diffs.
Manual notes
This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.