- Home
- Skills
- Agents & Orchestration
- workspace governance
More screenshots
Works with the AI Agents you already use
workspace governance
Audit, reorganize, and govern your workspace to reduce AI token overhead and stop agents from dumping files in repos.
Free
workspace governance
Example session with this skill installed
Audit my home directory for AI context overhead and suggest a reorganization plan.
- Read your context and instructions
- Compiled the workspace governance
- Generated the document
I have completed a read-only audit of your home directory using scripts/audit-workspace.py. I identified 14.2k tokens of overhead from legacy .cursorrules and 4.2GB of reclaimable space in node_modules.
Workspace Refactoring Plan
| Current Path | Target Path (Governed) | Type | Token Impact |
|---|---|---|---|
~/Documents/Notes | ~/knowledge/study/general | SSOT Vault | -1.2k |
~/dev/old-project | ~/archives/old-project | Dehydration | -800 |
~/models/llama3 | ~/ai-models/llm/llama3 | Read-Only Ref | 0 |
~/scripts/ai-skills | ~/agent-hub/skills | SSOT Skill | -2.1k |
Migration Commands (macOS/Linux)
# 1. Create parent folders only (mv creates the final folder)
mkdir -p ~/knowledge/study ~/agent-hub
# 2. Move and link: knowledge
mv ~/Documents/Notes ~/knowledge/study/general
ln -sfn ~/knowledge/study/general ~/Documents/Notes
# 3. Move and link: skills
mv ~/scripts/ai-skills ~/agent-hub/skills
ln -sfn ~/agent-hub/skills ~/scripts/ai-skills
Next steps
- Open the full interactive report at
./dist/.cache/dry-run-report.htmlto review specific file flags. - After you approve, run the
mvandlncommands to apply the new structure. - Confirm if you want to proceed with "dehydrating"
~/archives/to recover 4.2GB of disk space.
dry-run-report.html
PDF · document
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
Stop agents from turning your repositories into junkyards. This skill solves the "CWD dumping" problem where AI assistants scatter temporary scripts, notes, and build artifacts across your active projects. It provides a structured governance framework to keep code, RAG knowledge, and model weights physically separated while maintaining developer access through a zero-downtime migration system.
What it does
- Workspace Auditing scans directories for AI-related files to calculate real token overhead and identifies reclaimable disk space from heavy dependency folders.
- SSOT Enforcement establishes a Single Source of Truth for knowledge, model weights, and skills using a read-only permission matrix.
- Zero-Downtime Migration moves legacy folders to a governed structure while leaving symlinks or junctions behind to prevent breaking existing scripts or IDE shortcuts.
- Bilingual Reporting generates interactive HTML dry-run reports in English and Traditional Chinese (zh-TW) with platform-specific command toggles.
- Spatial Routing automatically diverts non-code outputs like research notes or side-projects to dedicated sandboxes and knowledge vaults.
How it works
- Audit Phase runs the
audit-workspace.pyscript to map your current directory structure and calculate token bills for AI-loaded files. - Review Phase generates an interactive HTML report showing exactly which folders will move and the specific
lnorNew-Itemcommands required. - Execution Phase runs only after you approve the dry-run plan: it moves folders and creates symlinks (macOS/Linux) or Directory Junctions (Windows) so existing paths keep working.
- Cleanup Phase dehydrates archives by stripping
node_modulesand.venvfrom legacy projects after user confirmation.
Frameworks & tools
The core logic relies on a standalone Python 3 auditing script. It supports macOS, Linux, and Windows (PowerShell) workflows and integrates with AI coding tools like Claude Code, Cursor, and Windsurf by managing rules like .cursorrules and CLAUDE.md.
Why this beats prompting it yourself
Generic prompts often result in destructive file moves that break your build paths. This skill uses a specialized auditor and symlink strategy that ensures your tools can still find files while the agent's context stays lean and focused.
Use cases
- Context Reduction to shrink agent token usage by moving non-essential docs out of the active code root.
- Machine Reorganization to transition a messy home directory into a governed AI-first workspace.
- Project Scaffolding to link global RAG knowledge or shared skills into new project folders without duplication.
- Disk Recovery to find and purge deep
node_modulesor__pycache__hidden in old archives.
Safety
The auditor script is read-only: it never moves, deletes or uploads files, makes no network calls, and uses only the Python 3 standard library. Migration commands are shown for you to review, and nothing moves without your approval. Run it with --demo to see a sample report without scanning your machine.
Known limitations
Requires Python 3 for the auditing script. Windows users must use PowerShell for Junction creation. The HTML report requires an internet connection to load Tailwind CSS via CDN for styling.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Agents & Orchestration.
Requires Python 3. Windows moves require PowerShell. HTML report styles require CDN access. Script does not execute moves automatically; user must run generated commands.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed today
- Free with an Agensi account
- Software
Python