gaelic-ghost/productivity-skills160 installs

project-workspace-cleaner

Q: How do I install this agent skill?

Run npx skills add https://github.com/gaelic-ghost/productivity-skills --skill project-workspace-cleaner.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

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.

How do I install this agent skill?

npx skills add https://github.com/gaelic-ghost/productivity-skills --skill project-workspace-cleaner

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
The project-workspace-cleaner skill is a read-only hygiene auditor for local repositories. It identifies build artifacts and large transient files to suggest cleanup opportunities without performing any deletions or network operations. Security analysis confirms the skill uses safe configuration parsing, restricts itself to standard filesystem metadata access, and contains strong safety guardrails in its instructions and prompt templates. No malicious patterns or security risks were detected.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues
Runlayerwarn
4/9 files flagged

What does this agent skill do?

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:
1. CLI flags
2. config/customization.yaml
3. config/customization.template.yaml
4. 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

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/gaelic-ghost/productivity-skills/project-workspace-cleaner">View project-workspace-cleaner on skillZs</a>