file-organizer

Files (2)

• EVAL.yaml
• SKILL.md

SKILL.md (first lines)

# File Organizer

Reorganize project files into a well-structured directory layout.

## Overview

This skill scans a project directory, identifies file types and purposes,
then moves files into a clean, conventional structure. It adapts to the
project type (Node.js, Python, Go, etc.) and follows community standards.

## Phase 1: Analysis

1. Scan the project root for all files and directories
2. Identify the project type from config files (package.json, pyproject.toml, go.mod)
3. Catalog each file's purpose: source, test, config, asset, documentation
4. Identify files that are misplaced or unconventionally located

**Checkpoint**: Present the analysis summary to the user before proceeding.

## Phase 2: Planning

1. Design the target directory structure based on project type:
   - Node.js: `src/`, `test/`, `docs/`, `scripts/`, `assets/`
   - Python: `src/{package}/`, `tests/`, `docs/`
   - Go: `cmd/`, `internal/`, `pkg/`, `docs/`
2. Create a move plan mapping current paths to target paths
3. Identify import/require statements that will need updating
4. Check for potential conflicts (files with same name in different dirs)

**Checkpoint**: Show the move plan and ask for confirmation.

## Phase 3: Execution

1. Create target directories
2. Move files according to the plan
3. Update import paths in all affected source files
4. Update configuration files (tsconfig, webpack, etc.) with new paths
5. Run the project's build/test command to verify nothing broke

**Checkpoint**: Report results and any issues encountered.

## Phase 4: Cleanup

1. Remove empty directories left behind
2. Update `.gitignore` if needed
3. Create a summary of all changes made

## Guidelines

- Never delete files without explicit user confirmation
- Always create a backup suggestion before large moves
- Preserve git history by using git mv when possible
- Handle circular dependency issues in import updates
- If build fails after reorganization, revert and report

From gxcsoccer/skillprobe, MIT.

More from gxcsoccer/skillprobe