Agent skill · writing content · aiskillstore
file-organization
Organize project files and folders for maintainability and scalability. Use when structuring new projects, refactoring folder structure, or establishing conventions. Handles project structure, naming conventions, and file organization best practices.
Why this skill is useful
Codifies project structure conventions and naming standards that the AI could infer but now doesn't have to guess.
What it needs
About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Project File Organization When to use this skill New Projects: Initial folder structure design Project Growth: Refactoring when complexity increases Team Standardization: Establish consistent structure Instructions Step 1: React/Next.js Project Structure Step 2: Node.js/Express Backend Structure Step 3: Feature-Based Structure (Large-Scale Apps) Step 4: Naming Conventions File Names: Folder Names: Variable/Function Names: Step 5: index.ts Barrel Files components/ui/index.ts: ❌ Bad example: Output format Project Template Constraints Required Rules (MUST) 1. Consistency: Entire team uses the same rules 2. Clear Folder Names: Roles must be explicit 3. Max Depth: Recommend 5 levels or fewer Prohibited (MUST NOT) 1. Excessive Nesting: Avoid 7+ levels of folder depth 2. Vague Names: Avoid utils2/, helpers/, misc/ 3. Circular Dependencies: Prohibit A → B → A references Best practices 1. Colocation: Keep related files close (component + styles + tests) 2. Feature-Based: Modularize by feature 3. Path Aliases: Simplify imports with @/ tsconfig.json: Usage: References React File Structure Node.js Best Practices Clean Architecture Metadata Version Current Version: 1.0.0 Last Updated: 2025-01-01 Compatible Platforms: Claude, ChatGPT, Gemini Tags #file-organization #project-structure #folder-structure #naming-conventions #utilities Examples Example 1: Basic usage <!-- Add example content here --> Example 2: Advanced usage <!-- Add advanced example content here -->
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/file-organization