repo-hygienelisted

Pre-PR checklist and repo cleanup for data science and analytics projects. Use this skill BEFORE creating a PR, merging branches, or handing off a repo. Catches common mistakes that waste hours later: data files committed to git, hardcoded paths, runtime artifacts tracked, branch ownership confusion, internal docs drifting from deliverables, and client data in public repos. Also use when the user says "clean up the repo", "is this ready to merge?", "prepare for handover", "before we push", "repo hygiene", or when you notice tracked .csv, .db, .parquet, or /Users/ paths during any file operation. Especially important for repos with multiple contributors working on parallel branches.
wan-huiyan/claude-ecosystem-hygiene · ★ 0 · Data & Documents · score 71

Install: claude install-skill wan-huiyan/claude-ecosystem-hygiene

# Repo Hygiene A pre-PR checklist and repo cleanup guide built from real mistakes that cost hours to fix. Every item here came from a real incident where something was committed, merged, and then had to be painfully undone. ## When to Use - Before running `gh pr create` - Before merging any branch - When someone asks "is this repo clean?" - When preparing a repo for handover to another team member - When you notice data files, absolute paths, or runtime artifacts during any file operation ## The Pre-PR Checklist Run through these checks in order. Each one has burned real teams. ### 1. Branch Ownership **The problem:** You commit deliverable fixes on a feature branch, then need to cherry-pick them onto the correct branch. Cherry-picking commits that touch files across concerns (webapp + deliverables + analysis) creates merge conflicts and duplicated work. **Before your first commit on any branch, answer:** "Which files does this branch own?" | Branch type | Owns | Does NOT own | |---|---|---| | `feature/webapp-*` | `webapp/`, `tests/`, `requirements-web.txt` | `deliverables/`, `analysis/`, `ANALYSIS_FINDINGS.md` | | `fix/review-*` | `deliverables/`, `analysis/`, `ANALYSIS_FINDINGS.md`, `docs/` | `webapp/` | | `docs/*` | `docs/`, `README.md`, `.md` files | Code files | **Rule:** If a commit touches files from two different ownership groups, split it into two commits on two branches. The 5 minutes you spend now saves the 30-minute cherry-pick session later. **This app