Works with the AI Agents you already use
janitor
Safely audit, preserve, and quarantine temporary AI agent artifacts and workflow clutter.
Free
janitor
Example session with this skill installed
We're done with the checkout work. Clean up whatever the AI agents left behind in this repo, but save any decisions first.
- Read your context and instructions
- Compiled the janitor
- Generated the document
Summary
I audited the repo in read-only mode and found 7 places where the AI agents left work behind. 3 are safe to quarantine, 1 must stay, and 3 need your decision.
Nothing was moved or changed. I also pulled out 3 decisions that exist nowhere else and are ready to be saved to docs/decisions.md before anything is cleaned up.
Janitor Report
Mode: Audit · Project: demo-shop
| Path | Verdict | Why |
|---|---|---|
checkout-eval-workspace/ | Quarantine | Finished evaluation (3 of 3 passed). Untracked, no nested repo, no links leaving the project, nothing references it. 4 files, 1.5 MB |
.superpowers/ | Quarantine | Every task in the plan is checked off ("all tasks done"). Untracked |
.claude/worktrees/spike-edge-cache | Quarantine (git worktree move) | No commits that exist only on its branch, no uncommitted changes. The branch stays |
.claude/worktrees/feature-coupons | Keep | Its branch has 1 commit that is not in main: 7d267ce wip: coupon stacking cap |
payments-sandbox-workspace/ | Your call | Nested repository detected (it has its own .git). I won't touch it unless you name it |
scratch/ | Your call | scratch/shared-cache is a symlink that points outside the project. I did not follow it |
tmp/debug.sql | Your call | Could contain real data. I did not open it and am not proposing removal |
Decisions to preserve
Found in checkout-eval-workspace/ and not yet in your docs. Proposed entries for docs/decisions.md, in its existing format:
## 2026-10-19: Prices are stored as integer cents
The checkout evaluation caught a float rounding bug in the coupon total. All money values use integer cents (`toCents`).
## 2026-10-19: Stripe webhook handler must be idempotent
Stripe delivers webhooks at least once. Deduplicate on `event.id` so retries do not double-apply.
## 2026-10-19: Coupon stacking is capped at 2 per order
Tax is calculated per line item, so unlimited stacking breaks the totals.
Not copied, on purpose
- A line in
progress.mdthat looks like a Stripe key. Left out of the docs and this report. If it was a real key, rotate it. run.log(1.5 MB, over the 1 MB reading limit) and progress chatter such as "task 3 complete".scratch/notes.mdholds an idea marked "not decided", so there is no decision to record.
If you confirm
- Append to
.gitignore(existing lines untouched):.janitor/,.superpowers/,.claude/worktrees/,checkout-eval-workspace/ - Add the 3 entries above to
docs/decisions.md - Move the 3 "Quarantine" items to
.janitor/trash/<timestamp>/, where you can move them back - Save a report to
.janitor/report/
Next steps
- Reply with an explicit go-ahead, for example "yes, quarantine those three and save the decisions". "Looks good" will not be treated as permission.
- Merge or commit
feature/couponsbefore you ever remove that worktree. - Tell me if you want
payments-sandbox-workspace/orscratch/handled; I'll check for unpushed work first.
janitor.pdf
PDF · document
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
Development workflows involving AI agents often leave behind a trail of temporary directories, scratch files, and evaluation outputs that clutter the repository. This skill audits your workspace to identify workflow artifacts, preserves critical engineering decisions buried in temporary logs, and safely moves approved clutter into a reversible quarantine.
What it does
- Workspace auditing identifies temporary AI-generated folders and scratch files across the project.
- Artifact classification tiers findings into safe, suspicious, or protected categories based on safety rules.
- Knowledge extraction captures architectural decisions and rationale from temporary files before they are removed.
- Safety verification checks for nested repositories, symlinks, and uncommitted git changes to prevent data loss.
- Reversible quarantine moves files to a timestamped trash directory instead of permanent deletion.
How it works
- Detect conventions by locating existing documentation targets like
ADRlogs orREADMEfiles for preservation. - Scan and audit the project using specific patterns to identify temporary agent artifacts.
- Propose cleanup by presenting a structured report of what will be moved, preserved, or skipped.
- Execute quarantine only after explicit user confirmation, updating
.gitignoreto prevent future noise.
Frameworks & tools
This skill is framework-agnostic and works with any AI agent capable of file operations. It is optimized for environments with git and standard shell utilities like find but includes manual fallbacks for restricted environments.
Why this beats prompting it yourself
Generic cleanup prompts often delete valuable implementation notes or accidentally wipe node_modules and .env files. This skill uses a strict classification engine and multi-step safety checks (symlink resolution and git status audits) that simple prompts ignore.
Use cases
- Post-implementation cleanup after a multi-step agent task finishes.
- Benchmark auditing to remove evaluation workspaces while saving results.
- Worktree management to safely identify and remove stale git worktrees.
- Repository hygiene for teams using multiple AI tools that generate distinct cache folders.
Known limitations
Does not support permanent deletion, only quarantine. Requires manual confirmation for directories over 100MB or files exceeding 100KB to ensure safety.
How to use
Skills on Agensi run inside your AI agent. Copy the prompt, paste it into your agent, and it connects to Agensi and installs this skill for you. If a payment is needed, your agent shows it to you first.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scanned
Verified clean 1 day ago
- Free to download with an account
Requires