# folder-organization

folder-organization sets practical rules for project folders, file names, and repository cleanup. Use it when starting a project or reshaping an existing research or development tree.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 150 installs · ★ 23 repo stars
- Author: Delphine-L
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Delphine-L/claude_global/tree/HEAD/skills/project-management/folder-organization/SKILL.md
- Updated: 2026-05-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/folder-organization

## What it does

This skill helps an agent plan a directory layout and keep project files easy to locate. It separates source code, data, documentation, tests, and generated results, with layouts for research, development, bioinformatics, and notebook-based analysis. It also covers naming patterns, session notes, and numbered notebook sequences.

The package includes guidance for `.gitignore`, project cleanup, deprecation, documentation, and `MANIFEST.md` navigation. Reorganization steps include finding old paths in Python and notebook files, checking file counts, and testing moved scripts or notebooks. Keep originals in `data/raw/` and leave them unchanged; otherwise the source data cannot serve as a stable reference. The skill relies on `Read`, `Grep`, `Glob`, and `Bash`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Delphine-L/claude_global --skill folder-organization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/folder-organization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/folder-organization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Delphine-L/claude_global --skill folder-organization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/folder-organization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Delphine-L/claude_global --skill folder-organization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/folder-organization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Delphine-L/claude_global skills/project-management/folder-organization
```

2. **Manually: put the files in place**
- File: `.github/skills/folder-organization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Delphine-L/claude_global --skill folder-organization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Delphine-L/claude_global --path skills/project-management/folder-organization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/folder-organization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Delphine-L/claude_global --skill folder-organization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Delphine-L/claude_global/tree/HEAD/skills/project-management/folder-organization/SKILL.md

## When to use it
- separate source code from data and generated files
- choose a folder layout for a research repository
- standardize names for files and notebooks
- trace broken paths after moving files
- move obsolete material into a recoverable archive

## Example prompts
- Organize this repository with a research project folder structure.
- Review the names in `notebooks/` and suggest a consistent naming scheme.
- Find references to moved `.json`, `.csv`, and `.png` files in the Python and notebook code.

## Similar
- [folder-structure-blueprint-generator](https://affpapa.org/en/nevibecode/skills/folder-structure-blueprint-generator.md) — skill · 9438 installs
- [file-organization](https://affpapa.org/en/nevibecode/skills/akillness-file-organization.md) — skill · 406 installs
- [organization-best-practices](https://affpapa.org/en/nevibecode/skills/organization-best-practices.md) — skill · 38800 installs
- [directory-build-organization](https://affpapa.org/en/nevibecode/skills/directory-build-organization.md) — skill · 4800 installs
- [capgo-organization-management](https://affpapa.org/en/nevibecode/skills/capgo-organization-management.md) — skill · 744 installs
- [recipe-organize-drive-folder](https://affpapa.org/en/nevibecode/skills/recipe-organize-drive-folder.md) — skill · 32100 installs

From the same set: [delphine-l/claude_global](https://affpapa.org/en/nevibecode/by/delphine-l/claude_global.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
