// Audit and clean Codex-created Git worktrees and leftover worktree directories safely. Use when disk usage appears inflated by ~/.codex/worktrees, Git worktree metadata, detached Codex worktrees, stale branch worktrees, or when the user asks to map worktrees to pull requests before deletion.
Use when Codex needs to write, rewrite, critique, or reply on Twitter/X in Jason Liu's personal voice. Trigger for requests like "tweet like me", "write this in my style", "make this sound like Jason", "draft a reply", or when Jason asks for Twitter copy about Codex, product building, feedback, launches, quote-tweets, or operator/value takes.
Audit AI-generated or AI-shaped backend/general code diffs for duplicate helpers, over-defensive control flow, broad exception wrappers, speculative scaffolding, comment/docstring boilerplate, local style drift, hallucinated APIs/dependencies, fixture-shaped test hacks, and obvious safety/performance gaps. Use when reviewing or safely cleaning up Python, TypeScript, or other implementation code after a feature, bugfix, or prototype pass.
Audit AI-generated or AI-looking frontend implementations, UI screenshots, and design diffs for generic AI aesthetics, card/gradient/font tells, weak UX copy, accessibility gaps, brittle responsive behavior, and one-off design-system drift. Use when reviewing or restyling React, Tailwind, shadcn/ui, HTML/CSS, landing pages, dashboards, or app screens to make the UI feel more intentional without a full redesign unless explicitly requested.
Draft, rewrite, or critique executive-facing communication so it is answer-first, concise, evidence-backed, audience-specific, and explicit about decisions or asks. Use for leadership updates, launch/status readouts, board or staff prep, escalation notes, Slack/email updates to executives, PR/FAQ summaries, weekly business updates, and turning messy project context into a clear executive narrative.
Visual-reference-to-app implementation loop for building or restyling a web app screen to match a provided reference image. Use when Codex is asked to take a screenshot/reference/mockup/image and build an app or route that looks like it, especially when the task requires hosting the app, capturing Playwright screenshots, comparing against the reference, and repeatedly editing until the result is close.
Build or refine single-file information-first HTML artifacts, especially index.html or text.html pages, with strong information hierarchy, restrained styling, accessible semantics, and minimal AI-generated frontend tells. Use when creating static HTML reports, research pages, explainers, briefs, dashboards, note indexes, or simple front ends whose goal is comprehension rather than marketing conversion.
| name | clean-worktrees |
| description | Audit and clean Codex-created Git worktrees and leftover worktree directories safely. Use when disk usage appears inflated by ~/.codex/worktrees, Git worktree metadata, detached Codex worktrees, stale branch worktrees, or when the user asks to map worktrees to pull requests before deletion. |
Use this skill when ~/.codex/worktrees or repository .git/worktrees directories are large, or when the user asks which worktrees are safe to remove.
Measure disk first:
df -h / /System/Volumes/Data
du -sh ~/.codex ~/.codex/worktrees 2>/dev/null
Audit before cleanup. Prefer the bundled script:
python3 ~/.codex/skills/clean-worktrees/scripts/clean_worktrees.py \
--repo ~/path/to/repo \
--root ~/.codex/worktrees \
--audit-dir ~/.codex/worktree-cleanup-audit \
--min-age-hours 24
Interpret risk:
Apply cleanup only after the audit result is clear:
python3 ~/.codex/skills/clean-worktrees/scripts/clean_worktrees.py \
--repo ~/path/to/repo \
--root ~/.codex/worktrees \
--audit-dir ~/.codex/worktree-cleanup-audit \
--apply \
--include-dirty \
--min-age-hours 24
Prune repository metadata after removals:
git -C ~/path/to/repo worktree prune
Verify:
git -C ~/path/to/repo worktree list --porcelain
du -sh ~/.codex ~/.codex/worktrees 2>/dev/null
df -h / /System/Volumes/Data
For named branch worktrees, map branches to PRs before deletion:
gh -C <repo> pr list --head <branch> --json number,title,url,state,headRefName,baseRefName
Detached worktrees do not map cleanly to PRs by branch. Treat them as not PR-backed unless the worktree has a named branch or a remote branch can be inferred from local metadata.
rm or rm -rf.~/.codex/worktree-cleanup-audit.git status --porcelaingit diff --binary24 hours, to avoid deleting active sessions.worktree remove --force for registered worktrees.~/.Trash/codex/<timestamp>/ instead of deleting them directly.