ComposioHQ/file-organizer

Organizador de Arquivos

Esta skill atua como seu assistente pessoal de organização, ajudando você a manter uma estrutura de arquivos limpa e lógica em todo o computador, sem a sobrecarga mental da organização manual constante.

Quando Usar Esta Skill

• Sua pasta de Downloads está uma bagunça caótica
• Você não consegue encontrar arquivos porque estão espalhados por todo lado
• Você tem arquivos duplicados ocupando espaço
• Sua estrutura de pastas não faz mais sentido
• Você quer estabelecer melhores hábitos de organização
• Você está iniciando um novo projeto e precisa de uma boa estrutura
• Você está limpando antes de arquivar projetos antigos

O Que Esta Skill Faz

1. Analisa a Estrutura Atual: Revisa suas pastas e arquivos para entender o que você tem
2. Encontra Duplicatas: Identifica arquivos duplicados em todo o sistema
3. Sugere Organização: Propõe estruturas de pastas lógicas baseadas no seu conteúdo
4. Automatiza Limpeza: Move, renomeia e organiza arquivos com sua aprovação
5. Mantém Contexto: Toma decisões inteligentes com base em tipos de arquivo, datas e conteúdo
6. Reduz Bagunça: Identifica arquivos antigos que você provavelmente não precisa mais

Como Usar

A Partir do Seu Diretório Inicial

cd ~

Em seguida, execute o Claude Code e peça ajuda:

Ajude-me a organizar minha pasta Downloads

Encontre arquivos duplicados na minha pasta Documentos

Revise meus diretórios de projeto e sugira melhorias

Tarefas Específicas de Organização

Organize estes downloads em pastas adequadas de acordo com o que são

Encontre arquivos duplicados e me ajude a decidir quais manter

Limpe arquivos antigos que não toco há mais de 6 meses

Crie uma estrutura de pastas melhor para meu [trabalho/projetos/fotos/etc]

Instruções

Quando um usuário solicitar ajuda com organização de arquivos:

1. Entenda o Escopo

   Faça perguntas esclarecedoras:

   • Qual diretório precisa ser organizado? (Downloads, Documentos, pasta inicial inteira?)
   • Qual é o principal problema? (Não encontra coisas, duplicatas, muito bagunçado, sem estrutura?)
   • Algum arquivo ou pasta a evitar? (Projetos atuais, dados sensíveis?)
   • Quão agressivamente organizar? (Limpeza conservadora vs. abrangente)

2. Analise o Estado Atual

   Revise o diretório alvo:

   # Obter visão geral da estrutura atual
   ls -la [diretorio_alvo]
   
   # Verificar tipos e tamanhos de arquivos
   find [diretorio_alvo] -type f -exec file {} \; | head -20
   
   # Identificar os maiores arquivos
   du -sh [diretorio_alvo]/* | sort -rh | head -20
   
   # Contar tipos de arquivo
   find [diretorio_alvo] -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn
   

   Resuma as descobertas:

   • Total de arquivos e pastas
   • Detalhamento por tipo de arquivo
   • Distribuição de tamanhos
   • Faixas de datas
   • Problemas óbvios de organização

3. Identifique Padrões de Organização

   Com base nos arquivos, determine agrupamentos lógicos:

   Por Tipo:

   • Documentos (PDFs, DOCX, TXT)
   • Imagens (JPG, PNG, SVG)
   • Vídeos (MP4, MOV)
   • Arquivos Compactados (ZIP, TAR, DMG)
   • Código/Projetos (diretórios com código)
   • Planilhas (XLSX, CSV)
   • Apresentações (PPTX, KEY)

   Por Finalidade:

   • Trabalho vs. Pessoal
   • Ativo vs. Arquivo
   • Específico de projeto
   • Materiais de referência
   • Arquivos temporários/raspados

   Por Data:

   • Ano/mês atual
   • Anos anteriores
   • Muito antigos (candidatos a arquivo)

4. Encontre Duplicatas

   Quando solicitado, busque por duplicatas:

   # Encontrar duplicatas exatas por hash
   find [diretorio] -type f -exec md5 {} \; | sort | uniq -d
   
   # Encontrar arquivos com o mesmo nome
   find [diretorio] -type f -printf '%f\n' | sort | uniq -d
   
   # Encontrar arquivos de tamanhos semelhantes
   find [diretorio] -type f -printf '%s %p\n' | sort -n
   

   Para cada conjunto de duplicatas:

   • Mostre todos os caminhos dos arquivos
   • Exiba tamanhos e datas de modificação
   • Recomende qual manter (geralmente o mais novo ou com melhor nome)
   • Importante: Sempre peça confirmação antes de excluir

5. Proponha Plano de Organização

   Apresente um plano claro antes de fazer alterações:

   # Plano de Organização para [Diretório]
   
   ## Estado Atual
   - X arquivos em Y pastas
   - [Tamanho] total
   - Tipos de arquivo: [detalhamento]
   - Problemas: [lista de problemas]
   
   ## Estrutura Proposta
   
   

   [Diretório]/ ├── Trabalho/ │ ├── Projetos/ │ ├── Documentos/ │ └── Arquivo/ ├── Pessoal/ │ ├── Fotos/ │ ├── Documentos/ │ └── Mídia/ └── Downloads/ ├── Para-Organizar/ └── Arquivo/

   
   ## Alterações que Farei
   
   1. **Criar novas pastas**: [lista]
   2. **Mover arquivos**:
      - X PDFs → Trabalho/Documentos/
      - Y imagens → Pessoal/Fotos/
      - Z arquivos antigos → Arquivo/
   3. **Renomear arquivos**: [quaisquer padrões de renomeação]
   4. **Excluir**: [duplicatas ou arquivos descartáveis]
   
   ## Arquivos que Precisam de Sua Decisão
   
   - [Liste quaisquer arquivos sobre os quais você não tem certeza]
   
   Pronto para prosseguir? (sim/não/modificar)
   

6. Execute a Organização

   Após aprovação, organize sistematicamente:

   # Criar estrutura de pastas
   mkdir -p "caminho/para/novas/pastas"
   
   # Mover arquivos com registro claro
   mv "caminho/antigo/arquivo.pdf" "caminho/novo/arquivo.pdf"
   
   # Renomear arquivos com padrões consistentes
   # Exemplo: "AAAA-MM-DD - Descrição.ext"
   

   Regras Importantes:

   • Sempre confirme antes de excluir qualquer coisa
   • Registre todas as movimentações para possível reversão
   • Preserve as datas de modificação originais
   • Lide com conflitos de nomes de arquivos graciosamente
   • Pare e pergunte se encontrar situações inesperadas

7. Forneça Resumo e Dicas de Manutenção

   Após organizar:

   # Organização Completa! ✨
   
   ## O Que Mudou
   
   - Criadas [X] novas pastas
   - Organizados [Y] arquivos
   - Liberados [Z] GB com a remoção de duplicatas
   - Arquivados [W] arquivos antigos
   
   ## Nova Estrutura
   
   [Mostrar a nova árvore de pastas]
   
   ## Dicas de Manutenção
   
   Para manter isso organizado:
   
   1. **Semanalmente**: Organizar novos downloads
   2. **Mensalmente**: Revisar e arquivar projetos concluídos
   3. **Trimestralmente**: Verificar novas duplicatas
   4. **Anualmente**: Arquivar arquivos antigos
   
   ## Comandos Rápidos para Você
   
   ```bash
   # Encontrar arquivos modificados esta semana
   find . -type f -mtime -7
   
   # Organizar downloads por tipo
   [comando personalizado para sua configuração]
   
   # Encontrar duplicatas
   [comando personalizado]
   

   Deseja organizar outra pasta?

Exemplos

Exemplo 1: Organizando Downloads (De Justin Dielmann)

Usuário: "Minha pasta Downloads está uma bagunça com mais de 500 arquivos. Ajude-me a organizá-la."

Processo:

1. Analisa a pasta Downloads
2. Encontra padrões: documentos de trabalho, fotos pessoais, instaladores, PDFs aleatórios
3. Propõe estrutura:
   • Downloads/
     • Trabalho/
     • Pessoal/
     • Instaladores/ (arquivos DMG, PKG)
     • Arquivo/
     • ParaOrganizar/ (coisas que precisam de decisão)
4. Pede confirmação
5. Move arquivos de forma inteligente com base no conteúdo e nomes
6. Resultados: 500 arquivos → 5 pastas organizadas

Exemplo 2: Encontrando e Removendo Duplicatas

Usuário: "Encontre arquivos duplicados em meus Documentos e me ajude a decidir quais manter."

Saída:

# Encontrados 23 Conjuntos de Duplicatas (156 MB no total)

## Conjunto de Duplicatas 1: "proposta.pdf"
- `/Documentos/proposta.pdf` (2,3 MB, modificado: 2024-03-15)
- `/Documentos/antigo/proposta.pdf` (2,3 MB, modificado: 2024-03-15)
- `/Desktop/proposta.pdf` (2,3 MB, modificado: 2024-03-10)

**Recomendação**: Manter `/Documentos/proposta.pdf` (mais recente no local correto)
Excluir as outras 2 cópias?

[Continuar para todas as duplicatas...]

Exemplo 3: Reestruturando a Pasta de Projetos

Usuário: "Revise meu diretório ~/Projetos e sugira melhorias."

Saída:

# Análise de ~/Projetos

## Problemas na Estrutura Atual
- Mistura de projetos ativos e arquivados (3+ anos de idade)
- Nenhuma convenção de nomenclatura consistente
- Alguns projetos na raiz, outros em subpastas aleatórias
- Pastas duplicadas (nome-do-projeto, nome-do-projeto-antigo, nome-do-projeto-v2)

## Estrutura Proposta

Projetos/ ├── Ativo/ │ ├── trabalho-cliente/ │ ├── projetos-laterais/ │ └── aprendizado/ ├── Arquivo/ │ ├── 2022/ │ ├── 2023/ │ └── 2024/ └── Modelos/

## Alterações Específicas
1. Mover 12 projetos não tocados desde 2022 → Arquivo/
2. Consolidar 4 pastas de projeto duplicadas
3. Renomear projetos para formato consistente: "nome-cliente-nome-projeto"
4. Criar Arquivo para trabalhos antigos

Deseja que eu implemente isso?

Exemplo 4: Organizando Fotos por Data

Usuário: "Organize minhas pastas de fotos por ano e mês."

Saída: Cria estrutura como:

Fotos/
├── 2023/
│   ├── 01-Janeiro/
│   ├── 02-Fevereiro/
│   └── ...
├── 2024/
│   ├── 01-Janeiro/
│   └── ...
└── Não-Organizadas/

Em seguida, move as fotos com base nos dados EXIF ou datas de modificação dos arquivos.

Tarefas Comuns de Organização

Limpeza de Downloads

Organize minha pasta Downloads - mova documentos para Documentos, 
imagens para Imagens, mantenha instaladores separados e arquive arquivos 
mais antigos que 3 meses.

Organização de Projetos

Revise minha estrutura de pastas de Projetos e me ajude a separar projetos 
ativos dos antigos que devo arquivar.

Remoção de Duplicatas

Encontre todos os arquivos duplicados na minha pasta Documentos e me ajude 
a decidir quais manter.

Limpeza da Área de Trabalho

Minha Área de Trabalho está coberta de arquivos. Ajude-me a organizar tudo 
na minha pasta Documentos corretamente.

Organização de Fotos

Organize todas as fotos nesta pasta por data (ano/mês) com base em quando 
foram tiradas.

Separação Trabalho/Pessoal

Ajude-me a separar meus arquivos de trabalho dos arquivos pessoais em toda 
a minha pasta Documentos.

Dicas Profissionais

1. Comece Pequeno: Comece com uma pasta bagunçada (como Downloads) para construir confiança
2. Manutenção Regular: Execute limpeza semanal nos Downloads
3. Nomenclatura Consistente: Use o formato "AAAA-MM-DD - Descrição" para arquivos importantes
4. Arquive Agressivamente: Mova projetos antigos para Arquivo em vez de excluir
5. Mantenha o Ativo Separado: Mantenha limites claros entre trabalho ativo e arquivado
6. Confie no Processo: Deixe o Claude lidar com a carga cognitiva de onde as coisas vão

Melhores Práticas

Nomenclatura de Pastas

• Use nomes claros e descritivos
• Evite espaços (use hífens ou underscores)
• Seja específico: "propostas-cliente" em vez de "docs"
• Use prefixos para ordenação: "01-atual", "02-arquivo"

Nomenclatura de Arquivos

• Inclua datas: "2024-10-17-anotacoes-reuniao.md"
• Seja descritivo: "relatorio-financeiro-q3.xlsx"
• Evite números de versão nos nomes (use controle de versão)
• Remova artefatos de download: "documento-final-v2 (1).pdf" → "documento.pdf"

Quando Arquivar

• Projetos não tocados há mais de 6 meses
• Trabalhos concluídos que podem ser referenciados depois
• Versões antigas após migração para novos sistemas
• Arquivos que você hesita em excluir (arquive primeiro)

Casos de Uso Relacionados

• Configurar organização para um novo computador
• Preparar arquivos para backup/arquivamento
• Limpar antes de liberar espaço de armazenamento
• Organizar pastas de equipe compartilhadas
• Estruturar novos diretórios de projeto