Workspace Clean

Name: Workspace Clean
Author: ats-kinoshita-iso

ats-kinoshita-iso/agent-workshop

Updated April 1, 2026
ats-kinoshita-iso/agent-workshop

workspace-clean runs automated workspace hygiene checks. It detects build artifacts, stale temp files, orphaned documentation, and other project-level clutter. It helps keep a repository tidy by surfacing things that should be cleaned up.

Key points

Automated workspace hygiene checks
Detects build artifacts and temp files
Finds orphaned docs
Flags project clutter

Workspace Clean by the numbers

Data as of Jul 7, 2026 (Skillselion catalog sync)

/plugin marketplace add ats-kinoshita-iso/agent-workshop

/plugin install workspace-clean@agent-workshop

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/ats-kinoshita-iso/agent-workshop/plugins/workspace-clean.svg)](https://skillselion.com/skills/ats-kinoshita-iso/agent-workshop/plugins/workspace-clean)

Last updated	April 1, 2026
Repository	ats-kinoshita-iso/agent-workshop ↗

What it does

Run automated workspace hygiene checks that detect build artifacts, stale temp files, orphaned docs and project clutter.

README.md

workspace-clean

Automated workspace hygiene checks that detect build artifacts, stale temp files, orphaned docs, and project-level clutter.

Skills

/clean — Interactive cleanup: shows findings, asks for confirmation before each action
/clean-audit — Read-only report of workspace hygiene issues

Hooks

Stop — Reports (does not delete) stale artifacts at session end

What It Checks

Category	Examples	Action
Build artifacts	`__pycache__/`, `node_modules/.cache/`, `dist/`, `.pyc` files	Flag for removal
Stale temp files	`.tmp`, `.bak`, `*.orig`, `.DS_Store`	Flag for removal
Orphaned docs	Markdown files referencing deleted code/files	Flag for review
Empty directories	Dirs with only `.gitkeep` where content was expected	Flag for review
Large files	Files > 500KB not in `.gitignore`	Flag for review
Stale branches	Local branches merged into main	Flag for cleanup

Configuration

Create .workspace-clean.json in your project root to customize behavior:

{
  "ignore": ["vendor/", "third_party/"],
  "max_file_size_kb": 500,
  "artifact_patterns": ["__pycache__", "*.pyc", ".DS_Store"],
  "check_orphaned_docs": true
}