Workspace Cleanup Audit

Overview

Run a read-only scan over repositories in ~/Workspace and report cleanup chores ranked by severity. Never delete, move, or modify files.

Workflow

• Load active customization config:

• Prefer <skill_root>/config/customization.yaml .

• Fall back to <skill_root>/config/customization.template.yaml .

• Run scripts/scan_workspace_cleanup.py .

• Review top-ranked findings first.

• Report findings with severity, repo, directory, category, size, and reason.

• Suggest cleanup actions as text only.

Commands

Use the default workspace scan:

uv run --with pyyaml python scripts/scan_workspace_cleanup.py

Scan a custom workspace root:

uv run --with pyyaml python scripts/scan_workspace_cleanup.py --workspace ~/Workspace

Return machine-readable output:

uv run --with pyyaml python scripts/scan_workspace_cleanup.py --json

Tune noise floor and stale threshold:

uv run --with pyyaml python scripts/scan_workspace_cleanup.py --min-mb 100 --stale-days 90

Configuration precedence:

• CLI flags

• config/customization.yaml

• config/customization.template.yaml

• Script hardcoded defaults

Customization Workflow

When a user asks to customize this skill, use this deterministic flow:

• Read active config from config/customization.yaml ; if missing, use config/customization.template.yaml .

• Confirm desired behavior for:

• workspace root

• thresholds (minMb , staleDays , maxFindings )

• severity cutoffs

• directory/file override rules

• Propose 2-4 option bundles with one recommended default.

• Create or update config/customization.yaml from template and set:

• schemaVersion: 1

• isCustomized: true

• profile: <selected-profile>

• Validate with a scan run and report changed keys plus behavior deltas.

Customization Reference

• Detailed knobs and examples: references/customization.md

• YAML schema and allowed values: references/config-schema.md

Output Contract

Each finding includes:

• severity

• repo

• directory

• category

• size_human

• score

• why_flagged

• suggested_cleanup

The report also includes:

• Top findings sorted by severity then size

• Repo summary ranked by total flagged size

Read-Only Rules

• Never run destructive commands.

• Never remove artifacts automatically.

• Never write into scanned repositories.

• Provide recommendations only.

Automation Templates

Use $workspace-cleanup-audit inside automation prompts so Codex consistently loads this skill behavior.

For ready-to-fill Codex App and Codex CLI (codex exec ) templates, including placeholders, safety defaults, and output handling, use:

• references/automation-prompts.md

References

• Pattern and threshold notes: references/patterns.md

• Automation prompt templates: references/automation-prompts.md

• Customization guide: references/customization.md

• Customization schema: references/config-schema.md