workspace-hygiene

Scan project roots and move non-whitelisted files to tests/temp.

1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/kellyson520/TG-ONE --skill workspace-hygiene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-hygiene
Source: https://github.com/kellyson520/TG-ONE/tree/main/.agent/skills/workspace-hygiene
Command: npx skills add https://github.com/kellyson520/TG-ONE --skill workspace-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps keep the project root clean by preventing temporary and non-whitelisted files from polluting the repository, reducing entropy and maintenance overhead.

Core Features & Use Cases

  • Root hygiene enforcement: defines an explicit root whitelist of allowed directories and files.
  • Automated cleanup: scans the project root and moves noncompliant items to tests/temp/ or domain-specific task folders.
  • Safe operation during task setup: ensures new debugging scripts are created in sanctioned locations to avoid clutter.

Quick Start

Run the hygiene script to scan the root and automatically relocate any noncompliant items to tests/temp.

Frequently Asked Questions about workspace-hygiene

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep my project root clean from temporary files and scripts?

To keep your project root clean, use a root hygiene scanner to enforce a whitelist of allowed files and automatically relocate noncompliant items to a tests/temp or domain-specific folder.

What is a root hygiene whitelist and how does it manage file organization?

A root hygiene whitelist is an explicit list of allowed directories and files in the project root. The scanner preserves whitelisted configs while moving noncompliant items to tests/temp.

Can I use automated workspace cleanup for multi-repo projects?

Yes, automated workspace cleanup applies across multi-repo projects. The scanner runs during new task setup and whenever the root directory contains extraneous files outside the allowed whitelist.

How do I automatically move non-whitelisted root files to a temp folder?

Run the hygiene script to scan the project root and automatically move any non-whitelisted root files to a tests/temp or domain-specific task folder.

Does the root cleanup scanner preserve configuration files during auto-fix?

Yes, the root cleanup scanner implements a safety check that preserves whitelisted configuration files during the auto-fix process while relocating extraneous items.

What is the best way to prevent debugging scripts from cluttering the project root?

The best way to prevent clutter is enforcing safe operation during task setup, ensuring new debugging scripts are created in sanctioned locations like tests/temp instead of the root.