janitor

Inventory repository cleanup targets and move approved items to janitor_trash with rollback.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/ledzepp1109/SYSopGPTWSL --skill janitor-ledzepp1109
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: janitor
Source: https://github.com/ledzepp1109/SYSopGPTWSL/tree/main/.codex/skills/janitor
Command: npx skills add https://github.com/ledzepp1109/SYSopGPTWSL --skill janitor-ledzepp1109

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safe cleanup and debloating of SYSopGPTWSL with safeguards: inventory candidates, propose an action plan, and only delete or relocate after explicit user confirmation.

Core Features & Use Cases

  • Inventory-driven cleanup: itemizes potential waste, duplicates, large artifacts, and obsolete files within the repo.
  • Safe execution with rollback: moves candidates into sysop/out/janitor_trash/ with a clear rollback path.
  • Repo-scoped by design: preserves source integrity and requires explicit approval before any destructive action.

Quick Start

Review the inventory, approve safe candidates, and trigger the cleanup to move items to sysop/out/janitor_trash with an optional rollback.

Frequently Asked Questions about janitor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely clean up repository waste without permanently deleting files?

Safe repo cleanup works by inventorying potential waste and moving candidates into sysop/out/janitor_trash after explicit user approval. This relocates obsolete files rather than deleting them, ensuring source integrity is preserved.

How can I inventory large artifacts and duplicates before removing them from my repo?

You can inventory large artifacts and duplicates by running a repo-scoped scan that itemizes potential waste. The tool then proposes a removal or relocation plan, which you must explicitly approve before any action is applied.

Can I rollback a repository cleanup if I accidentally remove the wrong files?

Yes, you can rollback a repository cleanup because the process defaults to reversible moves into sysop/out/janitor_trash. A clear rollback command is provided alongside post-action verification to ensure traceability.

What is the best way to debloat a repository while preserving source integrity?

Debloating a repository safely requires an inventory-driven approach that proposes an action plan and only deletes or relocates items after explicit user confirmation. This prevents accidental loss of critical source files.

Does repo cleanup require manual approval before executing destructive actions?

Yes, repo cleanup requires explicit user approval before any destructive action. The tool generates an inventory and proposed plan, then waits for your confirmation to move items to the trash directory.

When should I not use automated repo cleanup for removing obsolete files?

You should not use automated repo cleanup without reviewing the inventory plan, as the tool is repo-scoped and requires explicit approval. Always verify the proposed candidates before confirming any relocation or removal.