# ProjectOrganizer

> Organize folder structures, cleanup projects, create templates. USE WHEN organize, clean up, structure folder, reorganize, naming convention.

- **Type:** Skill
- **Install:** `agentstack add skill-phuaky-pai-skills-projectorganizer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [phuaky](https://agentstack.voostack.com/s/phuaky)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [phuaky](https://github.com/phuaky)
- **Source:** https://github.com/phuaky/pai-skills/tree/main/skills/ProjectOrganizer

## Install

```sh
agentstack add skill-phuaky-pai-skills-projectorganizer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ProjectOrganizer

Audit, clean, and organize project folder structures.

---

## Trigger Phrases

- "organize this folder"
- "clean up the structure"
- "help me reorganize"
- "what do we have here"
- "list everything"
- "create a template"
- "apply naming convention"

---

## Workflow Routing

| Trigger | Workflow |
|---------|----------|
| "organize", "clean up" | `Workflows/Audit.md` |
| "list", "what do we have" | `Workflows/Inventory.md` |
| "create template" | `Workflows/CreateTemplate.md` |
| "archive", "move old" | `Workflows/Archive.md` |

---

## Standard Folder Structures

### Project Folder (Agency/Client Work)
```
project-name/
├── README.md           # Project overview
├── SPEC.md             # Requirements/spec
├── meeting/            # Meeting transcripts & notes
│   └── YYYY-MM-DD-topic.md
├── assets/             # Raw inputs from client
├── output/             # Deliverables
├── _internal/          # Internal notes (not shared)
└── archive/            # Old versions
```

### Event Folder
```
event-YYYY-MM-DD-name/
├── README.md           # Event overview
├── slides/             # Presentation files
├── scripts/            # Speaking scripts
├── data/               # Attendee data, responses
├── assets/             # Images, media
└── follow-up/          # Post-event materials
```

### Guild/Organization Folder
```
guild-name/
├── README.md           # Overview
├── 1-events/           # Event folders
├── 2-community/        # Community resources
├── 3-vibe-ops/         # Operations
│   ├── projects/       # Active projects
│   └── deals/          # Pipeline tracking
├── 4-agency/           # Client work
│   └── projects/       # Client folders
└── archive/            # Completed/old
```

---

## Naming Conventions

### Folders
- **Projects:** `clientcode-project-name` (e.g., `roland001-personal-brand`)
- **Events:** `YYYY-MM-DD-event-name` (e.g., `2026-01-16-cc-workshop`)
- **General:** `lowercase-with-dashes`

### Files
- **Docs:** `TitleCase.md` or `lowercase-with-dashes.md`
- **Data:** `YYYY-MM-DD-description.ext`
- **Versions:** `filename-v1.ext`, `filename-v2.ext`

### Prefix Conventions
- `_internal/` - Not for sharing
- `_archive/` - Old versions
- `_temp/` - Temporary files (delete later)

---

## Audit Process

### Step 1: Inventory
List all contents with:
- File/folder count
- Types of content
- Last modified dates
- Size (if relevant)

### Step 2: Identify Issues
- [ ] Inconsistent naming
- [ ] Duplicates
- [ ] Orphaned files
- [ ] Missing structure
- [ ] Old/stale content

### Step 3: Propose Changes
Present reorganization plan:
- What to rename
- What to move
- What to archive
- What to delete
- New folders to create

### Step 4: Execute (with approval)
- Create new structure
- Move files
- Rename as needed
- Archive old content

---

## Quick Commands

### `list`
Show folder contents with context

### `audit`
Full structure analysis with recommendations

### `apply-naming`
Fix naming to match conventions

### `create-structure`
Create standard folder structure

### `archive-old`
Move old content to archive

---

## Integration

- **MeetingProcessor:** Ensure meeting outputs go to correct folders
- **FounderOps:** Set up new project folders properly
- **DailyUpdate:** Track organization tasks

---

## Example

**Request:** "organize the my-project folder"

**Output:**
```markdown
## Folder Audit: my-project

### Current State
- 4 main directories
- 12 project subfolders
- Mixed naming conventions
- Some orphaned files in root

### Issues Found
1. ❌ `16jan-cc-event` should be `1-events/2026-01-16-cc-workshop`
2. ❌ `vibe-ops` should be `3-vibe-ops`
3. ❌ Loose files in root: `notes.md`, `todo.txt`
4. ❌ Duplicate: `proposal.md` and `proposal-v2.md`

### Proposed Changes
1. Move event folder to events directory
2. Rename vibe-ops with prefix
3. Move loose files to appropriate locations
4. Archive old proposal, keep v2

### Execute?
[y/n]
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [phuaky](https://github.com/phuaky)
- **Source:** [phuaky/pai-skills](https://github.com/phuaky/pai-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-phuaky-pai-skills-projectorganizer
- Seller: https://agentstack.voostack.com/s/phuaky
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.