# Egg Info Hygiene

> Handle `src/*.egg-info` diffs in Python repos (uv-driven) to avoid committing generated metadata unintentionally. Use when this capability is needed.

- Skill: `tomevault-io/egg-info-hygiene` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/egg-info-hygiene`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/egg-info-hygiene/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/egg-info-hygiene

---

<!-- BEGIN:compound:skill-managed -->
# Purpose
Keep commits/PRs clean when `src/*.egg-info/**` changes appear.

# When To Use
- `git diff` shows changes under `src/*.egg-info/**` (for example `PKG-INFO`, `requires.txt`).
- You did not intentionally change packaging metadata (version, dependencies, build backend).

# Procedure
- Identify intent:
  - If you did change packaging metadata (dependencies, project metadata, versioning), keep investigating whether `*.egg-info` is expected to be committed in this repo.
  - If you did not, treat `*.egg-info` as generated output.
- Confirm scope:
  - If diffs are only `src/*.egg-info/**`, treat as no-op for feature work.
  - If diffs include real source changes plus `*.egg-info`, keep the source changes and exclude the `*.egg-info` changes.
- Normalize the working tree using the repo's standard setup/install workflow (for uv repos, typically `uv sync --dev` and `uv pip install -e .`) and re-check whether the egg-info diffs persist.
- If egg-info remains tracked and noisy, document the repo policy explicitly in `AGENTS.md` (do not edit tool-managed fences) so future work treats these changes consistently.

# Notes
- `src/*.egg-info/**` is commonly generated by editable installs and may change due to environment/tooling rather than code intent.
- Do not let egg-info-only diffs drive a commit unless the repo explicitly treats them as source-controlled artifacts.
<!-- 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 -->

