workspace-cleanup

Audit Claude Code workspace for hygiene, git status, and MCP health.

29|12|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/matteotitta/genesys-skills --skill workspace-cleanup-matteotitta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-cleanup
Source: https://github.com/matteotitta/genesys-skills/tree/main/skills/meta/session/workspace-cleanup
Command: npx skills add https://github.com/matteotitta/genesys-skills --skill workspace-cleanup-matteotitta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses workspace bloat and configuration drift by performing a comprehensive audit of your Claude Code environment, ensuring your project structure, git status, and MCP integrations remain healthy and organized.

Core Features & Use Cases

  • Structured Auditing: Runs 5 distinct checks covering root hygiene, client folder compliance, skill system health, git status, and MCP/plugin configurations.
  • Actionable Reporting: Generates a clear pass/flag/action report that identifies stale files, missing documentation, or oversized dependencies.
  • Use Case: Use this before starting a new sprint or after a long period of development to ensure your project structure is compliant with your internal standards and that no sensitive files have been accidentally tracked.

Quick Start

Invoke the workspace cleanup skill to run a full audit of your current directory and generate a health report.

Frequently Asked Questions about workspace-cleanup

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

FAQPage Schema
How do I audit my workspace for configuration drift and stale files?

Workspace auditing detects configuration drift by scanning root hygiene, client folder compliance, skill system integrity, git status, and MCP plugin health, generating an actionable remediation report for flagged issues.

What does an automated hygiene audit check for in a development project?

An automated hygiene audit performs five diagnostic checks covering root directory cleanliness, client folder structure compliance, skill system integrity, git tracking status, and MCP plugin configuration health to identify bloat and misconfigurations.

Can I use this workspace cleanup tool to check MCP plugin health?

Yes, the workspace audit validates MCP plugin configurations as part of its comprehensive diagnostic check, flagging oversized dependencies and misconfigurations that could impact your Claude Code environment.

When should I run a workspace hygiene audit on my project?

Run a workspace hygiene audit before starting a new sprint or after extended development periods to ensure project structure complies with internal standards and no sensitive files have been accidentally tracked in git.

Do I need special dependencies to run a workspace maintenance audit?

No external dependencies are required. The audit requires access to the workspace root directory and local configuration files to validate system state and generate pass/flag/action remediation reports.

What's the best way to prevent configuration drift in Claude Code workspaces?

Preventing configuration drift involves running regular automated audits that check root hygiene, client structure, skill system health, git status, and MCP plugins, then addressing flagged items in the generated remediation report.