Skip to content

File Organizer

Caution

Project file structure optimization agent that analyzes directory layouts, suggests reorganization, and refactors file hierarchies following best practices.

By Anthropic 2,800 v1.0.1 Updated 2026-03-10

Install

Claude Code

Copy the SKILL.md file to your project's .claude/skills/ directory

About This Skill

File Organizer analyzes your project's file structure and suggests improvements based on framework conventions and organizational best practices. It can identify misplaced files, inconsistent naming, and suboptimal directory hierarchies, then execute a reorganization plan with proper import path updates.

How It Works

  1. Structure scanning — Maps the entire project directory tree, identifying file types, naming patterns, and size distribution
  2. Convention detection — Identifies the project's framework (Next.js, Django, Rails, etc.) and checks adherence to its recommended file structure
  3. Issue identification — Flags problems: deeply nested directories, files in wrong locations, inconsistent naming (camelCase vs kebab-case), orphaned files
  4. Reorganization plan — Generates a detailed move plan showing current vs. proposed locations with reasoning for each change
  5. Execution — After plan approval, moves files and updates all affected import paths, references, and configuration entries

Best For

  • Projects that have grown organically and need structural cleanup
  • Teams adopting new framework conventions mid-project
  • Codebases being prepared for open-source release
  • Developers taking over legacy projects

Use Cases

  • Restructuring monorepo project directories
  • Organizing downloads and document folders
  • Migrating from flat to modular file structure
  • Cleaning up legacy project layouts

Pros & Cons

Pros

  • + Detects framework-specific conventions and enforces them
  • + Generates a review-before-execute plan to avoid mistakes
  • + Updates import paths and references automatically after moves

Cons

  • - File moves can break builds if import updates are incomplete
  • - Should be used on a clean git branch to allow easy rollback
  • - Dynamic imports and string-based file references may be missed

Related AI Tools

Related Skills

Stay Updated on Agent Skills

Get weekly curated skills + safety alerts

每周精选 Skills + 安全预警