project-workspace-cleaner

Original：🇺🇸 English

Translated

2 scripts

Scan workspace repositories for cleanup opportunities using a read-only hygiene audit. Use when users ask to detect build/cache artifact buildup, stale large transient files, and prioritized cleanup chores by repository and directory.

2installs

Sourcegaelic-ghost/productivity-skills

Added on2026-03-09

NPX Install

npx skill4agent add gaelic-ghost/productivity-skills project-workspace-cleaner

SKILL.md Content

View Translation Comparison →

Project Workspace Cleaner

Run a read-only scan over repositories in a workspace root and rank cleanup chores by severity.

Inputs

Optional CLI overrides:

```
--workspace
```
```
--min-mb
```
```
--stale-days
```
```
--max-findings
```
```
--config
```
```
--json
```

Config precedence:

CLI flags
```
config/customization.yaml
```
```
config/customization.template.yaml
```
script defaults

Workflow

Resolve settings using the documented precedence.
Run
```
scripts/scan_workspace_cleanup.py
```
.
Record skipped paths when traversal or stat operations fail, then continue scanning remaining accessible paths.
Rank findings by severity, score, size, repo, and directory.
Return the ranked findings plus repo-level totals.
If there are no findings and no skipped paths, report the user-facing clean result.

Output Contract

Each finding includes:

```
severity
```
```
repo
```
```
directory
```
```
category
```
```
size_human
```
```
score
```
```
why_flagged
```
```
suggested_cleanup
```
Repo summary includes total flagged size and finding counts per severity.
JSON output includes
```
partial_results
```
and
```
skipped_paths
```
.
For user-facing clean runs, output exactly
```
No findings.
```
If any path is skipped, return a partial-results warning and list skipped paths instead of using the clean-run message.

Guardrails

Never run destructive commands.
Never remove artifacts automatically.
Never write into scanned repositories.
Provide recommendations only.

References

```
references/config-schema.md
```
```
references/customization.md
```
```
references/automation-prompts.md
```
```
references/patterns.md
```