organize-workspace

Organizes scattered workspace files into semantic folders by project, type, and purpose.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/SillyHippy/zo-skills --skill organize-workspace-sillyhippy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: organize-workspace
Source: https://github.com/SillyHippy/zo-skills/tree/main/skills/zo-organize-workspace
Command: npx skills add https://github.com/SillyHippy/zo-skills --skill organize-workspace-sillyhippy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Workspaces accumulate loose files over time, making it hard to find documents, datasets, and project materials. This Skill consolidates scattered files into a logical folder structure without deleting or damaging existing organization. ## Core Features & Use Cases - Semantic Grouping: Groups files by project, context, or domain first, then by file type, keeping related items together. - Protected Directories: Preserves managed structures such as directories containing zosite.json files and folders named Articles or Prompts. - Standard Folder Structure: Creates Projects, Research, Data, Documents, and Archive folders and documents the result in WORKSPACE_STRUCTURE.md. - Use Case: After weeks of ad-hoc work, your workspace root has dozens of loose PDFs, CSVs, and notes. Run this Skill to sort them into meaningful folders and receive a summary of every move. ## Quick Start Ask the assistant to organize the files in your workspace into logical folders by project and type.

Frequently Asked Questions about organize-workspace

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

FAQPage Schema
How do I organize scattered files in my workspace automatically?▼

Run the organize-workspace Skill to catalog loose files and move them into semantic folders like Projects, Research, Data, Documents, and Archive. It groups files by project or context first, then by file type, and reports every move.

How does the file organization decide where files go?▼

Files are grouped by semantic meaning first, such as project or domain, before considering file type. PDFs and reference material go to Research, CSVs and spreadsheets to Data, notes and plans to Documents, and outdated items to Archive.

Will organizing my workspace delete or overwrite existing folders?▼

No. The Skill consolidates without destroying: it keeps all original directories intact and never deletes folders. It also protects managed structures like directories containing zosite.json files and folders named Articles or Prompts.

Can I customize the folder structure used for organization?▼

Yes. After the run, the Skill asks about your organization preferences so the command can be modified for future use. The default structure of Projects, Research, Data, Documents, and Archive is only created if not already present.

What happens to files that do not fit any category?▼

Files requiring manual review or placement decisions are flagged in the output summary. The Skill notes them explicitly so you can decide where they belong rather than forcing an incorrect placement.