# Organize Workspace

> Organizes your scattered files into logical folders by project, type, and purpose

- Skill: `luokai0/organize-workspace` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add luokai0/organize-workspace`
- Raw SKILL.md: https://api.skillmd.com/api/skills/luokai0/organize-workspace/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: luokai0 (https://skillmd.com/u/luokai0)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/luokai0/organize-workspace

---


Consolidate scattered files into logical directories to improve workspace organization and discoverability.

# Protocol

1. **Assess current workspace structure**
   - Catalog loose files in the workspace directory
   - Identify existing folder structure and naming conventions
   - Determine semantic relationships and project groupings before considering file types

2. **Identify semantic organization opportunities**
   - Group files by project, context, or domain first
   - Preserve existing directories that represent meaningful organization
   - Look for related items that should stay together despite different file types

3. **Protect special directories**
   - Identify any directories containing `file zosite.json` files, as well as any directories called `Articles` or `Prompts`
   - Do not touch, move, or reorganize these directories—they are managed project structures
   - Leave them in place regardless of other organizational changes

4. **Create organized folder structure** (if not already present):
   - `Projects/` – for active and completed projects
   - `Research/` – for articles, PDFs, and reference materials
   - `Data/` – for spreadsheets, CSVs, and datasets
   - `Documents/` – for notes, plans, and written content
   - `Archive/` – for old or completed items

5. **Consolidate files by semantic meaning, then by type**:
   - Prioritize grouping by project or context over pure file type
   - Move related files together into semantic folders when meaningful
   - Within semantic folders, organize by type if needed

6. **Organize supporting files**:

   **Projects/** – Project folders and related files
   - Move project directories and associated content into this structure

   **Research/** – Articles, PDFs, and reference materials
   - Move: PDF files, research documents, reference articles, and external content

   **Data/** – Spreadsheets and datasets
   - Move: CSV files, XLSX files, and other tabular data

   **Documents/** – Notes, plans, and written content
   - Move: Markdown files, text documents, planning documents, and analysis

   **Archive/** – Old or completed items
   - Move: Outdated files, deprecated versions, and completed projects

7. **Consolidate without destroying**:
   - Review existing subdirectories for related content and redundancies
   - Integrate contents into the appropriate semantic structure
   - Keep all original directories intact—do not delete any folders

8. **Ensure there are no remaining loose files in the workspace directory**

9. **Document the new structure**:
   - Create `file WORKSPACE_STRUCTURE.md` at the root explaining the folder organization

# Output

Inform the user that the workspace has been reorganized:

- List the new folder structure created
- Provide a count of files moved and their destinations
- Suggest next steps for navigating the reorganized workspace
- Note any files that required manual review or decisions about placement
- Ask the user if they have any organization preferences that they would like to use in the future, modifying this command