Agent skill · ma08
personal-os-repo-cleanup
Use when the user asks to commit, clean, audit, reconcile, push, pull, or coordinate dirty personal_os changes across the VM and Mac checkouts, especially when live task-specific sessions may own folders, orphaned artifacts need curated commits, or divergent main histories must be synchronized safely.
What it needs
About 5k tokens when loaded.
What this skill does
Personal OS Repo Cleanup Overview Coordinate cleanup and synchronization of ~/pro/personalos across machines without trampling live task owners. By default, finish by reconciling committed histories with the remote, pushing the canonical merged main, and pulling or fast-forwarding each checkout. Preserve useful task evidence, local dirty work, and secrets. Workflow 1. Create or reuse a tracking task folder in context/daily/YYYY-MM-DD/.... Record the user request, scope, and running checklist in status.md. For complex cleanup, create a goal so progress can survive context shifts. 2. Inventory both repositories before changing anything. Use git status --porcelain=v1 -uall for the local VM checkout. For the Mac, use the configured SSH alias, usually: Save inventories, grouped summaries, and any helper scripts under the active task's task-progress-artifacts/scratchpad/. 3. Group dirty paths by ownership. Treat context/daily/<date>/<task-slug>/... as task-owned. Treat root files such as .gitignore, CLAUDE.md, scripts/, output/, and root task-progress-artifacts/ as non-task work requiring separate review. Use task metadata, transcripts, and zellij listings to decide whether a live owner exists. 4. Delegate only to clearly reachable owners. When a task has an active, unambiguous zellij/Codex owner, use $cross-session-message preview-first, then send a bounded commit instruction with --execute --submit enter. Record target session, tab, task group, and requested commit message. If the session is missing, ambiguous, ended, or is just a shell/gitui workspace, this cleanup session owns the commit. 5. Keep the git index safe. All sessions in a shared checkout share one index. Before staging, confirm git diff --cached --name-only is empty or contains only the scope you intend. If another session is working, prefer waiting or rechecking over committing a mixed index. 6. Stage explicitly and commit logically. Use pathspec files or explicit paths. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/personal-os-repo-cleanup