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.