import-organizer

name	import-organizer
description	Organizes and sorts import statements in code files. Use when imports are messy or need organization.
allowed-tools	["Read","Edit","Grep"]

Import Organizer

Automatically organize and sort import statements in JavaScript, TypeScript, Python, and other languages.

When to Activate

• "organize imports in this file"
• "sort the imports"
• "clean up import statements"
• "fix import order"

Process

1. Read the file to see current imports
2. Identify import groups:
   • External/third-party imports
   • Internal/local imports
   • Type imports (TypeScript)
   • Side-effect imports
3. Sort within groups alphabetically
4. Remove duplicates if any
5. Apply language-specific conventions:
   • JavaScript/TypeScript: External, then internal
   • Python: Standard library, third-party, local
6. Preserve comments attached to imports
7. Update the file with organized imports

Language-Specific Rules

JavaScript/TypeScript

// External packages first
import React from 'react'
import { useState } from 'react'
import axios from 'axios'

// Internal imports
import { Button } from './components/Button'
import { utils } from './utils'

// Type imports (TypeScript)
import type { User } from './types'

// Side-effect imports last
import './styles.css'

Python

# Standard library
import os
import sys
from datetime import datetime

# Third-party
import requests
from django.db import models

# Local
from .models import User
from .utils import helper

Best Practices

• Group by source (external vs internal)
• Sort alphabetically within groups
• Separate groups with blank lines
• Remove unused imports (warn user)
• Preserve special comments
• Follow language conventions