@fdrudi · tá tudo aqui

Joga o arquivo.
A pasta faz o resto.

Uma pasta do seu Mac que converte, comprime ou transcreve sozinha o que você soltar dentro dela. Uma skill conversa com você, monta a pasta e testa. Você não precisa programar.

importante

Só para Mac. A IA e a internet entram uma vez, na hora de montar. Depois a pasta roda no seu computador, de graça e sem internet.

código aberto · github · licença MIT Pega a skill

O repositório inteiro é a skill. Se você já tem o Claude Code ou o Codex, o passo 1 abaixo leva um minuto.

github.com/drudif/faca-suas-pastas-magicas
00 · a ideia

O que é uma pasta mágica

É uma pasta comum do Desktop, com uma tarefa ligada a ela. Você arrasta um vídeo para a pasta video>>audio. Alguns segundos depois, o mp3 está dentro de pronto/. Você não abre programa nenhum.

1 · CaiVocê solta o arquivo na pasta.
2 · O Mac trabalhaO macOS avisa que a pasta mudou e a tarefa roda sozinha.
3 · ProntoO resultado aparece na subpasta pronto/.

Ninguém precisa deixar um programa aberto esperando. O próprio Mac acorda a tarefa quando chega arquivo novo.

01 · antes de começar

O que você precisa ter

Um Mac macOS 12 ou mais novo. Windows e Linux não funcionam.
Uma IA de código Claude Code ou Codex, instalado. É ela que lê a skill e conversa com você. Nunca usou? O guia passo a passo da skill mostra a instalação do zero.
Internet Só durante a montagem.
Ferramentas do Mac A skill confere e avisa o que falta, e pede a sua licença antes de instalar. Duas podem aparecer: as Command Line Tools (xcode-select --install) e, para vídeo e áudio, o ffmpeg (brew install ffmpeg).

Transcrição local. Para transcrever áudio sem mandar nada para fora, a skill usa o Whisper, que só roda em Mac com chip da Apple (M1 ou mais novo) e baixa o modelo uma vez, na primeira execução.

02 · o caminho

Sete passos, do zero à pasta funcionando

Em cada um: o que você faz e o que acontece por trás. Você só digita no passo 1 e no passo 2. Depois é responder perguntas.

1

Instale a skill

você fazabra o Claude Code (ou o Codex) e mande esta frase:

diga para o agente Instale a seguinte skill: github.com/drudif/faca-suas-pastas-magicas

aconteceo agente baixa o repositório para a pasta de skills dele.

Prefere fazer à mão? Cole um destes dois comandos no Terminal:

# Claude Code
git clone https://github.com/drudif/faca-suas-pastas-magicas ~/.claude/skills/faca-suas-pastas-magicas

# Codex
git clone https://github.com/drudif/faca-suas-pastas-magicas ~/.agents/skills/faca-suas-pastas-magicas
2

Diga o que você quer

você fazconte a tarefa do jeito que vier. Exemplos:

  • "quero criar uma pasta mágica"
  • "uma pasta que comprime as fotos que eu jogar nela"
  • "uma pasta que transforma vídeo em mp3"

Não sabe o que pedir? Tudo bem: a skill mostra ideias e pergunta qual se parece com o seu dia.

acontecea skill é ativada e começa pela primeira pergunta. Ela nunca começa instalando.

3

Responda a entrevista

você fazresponda uma pergunta por vez, quase sempre com um número (1, 2…).

As perguntas seguem esta ordem, e a skill pula as que você já respondeu no passo 2:

  1. A tarefa. O que você faz hoje à mão toda vez que chega um arquivo?
  2. Entrada e saída. O que você joga na pasta e o que quer receber.
  3. O que muda o resultado. Por exemplo, acelerar quanto, ou o gif com que largura. Cada pergunta traz um valor recomendado.
  4. Local ou nuvem. Quase tudo roda local e ela só avisa. Só pergunta se a tarefa exigir serviço externo (veja a seção 05).
  5. O nome da pasta. Ela sugere entrada>>saida, como video>>gif.
  6. A confirmação. Ela resume tudo em uma frase e espera o seu "sim".

acontecenada é criado, instalado ou executado até você dizer "sim" ao resumo.

4

A skill monta e testa

você fazquase nada. Se ela pedir um arquivo seu para o teste, mande um de verdade.

aconteceem ordem:

  1. Confere o seu Mac e avisa o que falta.
  2. Copia o modelo para ~/minhas-pastas-magicas. Você edita essa cópia, nunca a skill.
  3. Escreve a receita: um arquivo pequeno que diz quais tipos de arquivo a pasta aceita e o que fazer com cada um.
  4. Testa a receita numa pasta temporária, sem instalar nada. Testa o seu arquivo e também um que deve falhar, para provar que os erros vão para o lugar certo.
  5. Instala: liga a pasta ao macOS e cria a pasta no Desktop.
5

Libere o Desktop

você fazse o macOS bloquear a pasta, dê a permissão. É a única parte que só você consegue fazer.

  1. Abra Ajustes do Sistema.
  2. Entre em Privacidade e Segurança, depois em Acesso total ao disco.
  3. Clique no + e escolha ~/Library/Application Support/minhas-pastas/MinhasPastas.app.
  4. Solte o arquivo de novo na pasta.

Por que isso existe. O macOS protege o Desktop de programas que você não autorizou. A permissão vai só para o MinhasPastas.app, que o kit cria para isso. Não dê acesso ao Terminal nem ao zsh.

acontecese a permissão faltar, o log mostra Operation not permitted. Depois de liberar, a pasta passa a funcionar.

6

Faça o teste

você fazarraste um arquivo seu para a pasta nova no Desktop.

aconteceem alguns segundos o resultado aparece em pronto/. Abra e confira o conteúdo, não só se o arquivo existe.

Quer ver o que o Mac está fazendo? Acompanhe o registro:

tail -f ~/Library/Logs/minhas-pastas.log

Aparece processando e, logo depois, ok: pronto/….

7

Mais uma pasta?

você fazresponda "sim" se quiser outra.

acontecea skill repete a entrevista para a próxima pasta, sem mexer nas que já existem. Uma pasta de cada vez.

03 · o que vem pronto

E quais pastas dá para criar

No repositório já vem uma pasta completa: video>>audio, que tira o áudio do vídeo e entrega um mp3. As outras a skill escreve na hora, a partir da sua entrevista. Estas são as ideias que ela mostra para quem não sabe por onde começar:

video>>audiotira o áudio e entrega mp3. Já vem pronta.
video>>giftransforma o vídeo em gif leve.
video>>1.15xacelera sem mudar o tom da voz.
video>>semsilenciocorta as pausas.
video>>transcricaotransforma a fala em texto (Whisper, local, chip da Apple).
imagem>>levecomprime e redimensiona fotos.
pdf>>textoextrai o texto do PDF.

Qualquer tarefa repetida vale, mesmo fora desta lista. A pergunta da skill é: "chega tal arquivo e eu faço tal coisa".

04 · onde vai cada arquivo

Nada é apagado

Dentro de cada pasta mágica, o kit separa o que aconteceu em três subpastas:

pronto/o resultado. É o que você veio buscar.
_originais/o arquivo que você soltou, guardado intacto.
_erros/o que não deu certo, por exemplo um vídeo sem áudio numa pasta de mp3.

Se a pasta receber um arquivo ainda sendo copiado, ela espera o tamanho parar de mudar antes de começar.

05 · local e nuvem

Quando o arquivo sai do seu computador

O padrão é local: sem internet, sem custo por uso e sem o arquivo sair do Mac. Algumas tarefas só existem em serviço externo, como isolar a voz de um áudio (ElevenLabs) ou escolher os melhores trechos de um vídeo (Gemini). Nesses casos a skill avisa antes, com três coisas:

  1. o arquivo sai do seu computador e vai para a empresa do serviço;
  2. você precisa de uma chave de acesso sua;
  3. o serviço pode cobrar por uso.

Ela oferece primeiro uma versão local, se existir. A pasta que usa serviço externo fica com a etiqueta vermelha no Finder, para você lembrar.

Sobre a chave. Nunca cole a chave na conversa. A skill manda você abrir um arquivo (.env, na pasta Application Support/minhas-pastas) e colar lá. Se a chave aparecer em texto, em log ou numa mensagem, troque-a no site do serviço.

06 · se travar

Problemas comuns

Nada acontece Veja o registro (tail -f ~/Library/Logs/minhas-pastas.log). Se aparecer Operation not permitted, falta a permissão do passo 5.
Arquivo em _erros/ A receita recusou o arquivo. Confira o tipo (a pasta aceita só algumas extensões) e o registro. Peça à skill para ajustar a receita.
Mudei a receita Peça para a skill instalar de novo. O agente do macOS lê uma cópia, então a mudança só vale depois disso.
No module named… A receita usa Python e falta um módulo. A skill sabe listar e instalar; peça a ela.

Para desinstalar

Dentro da pasta do kit, rode ./desinstalar.sh. Ele desliga as pastas e não apaga pastas nem arquivos seus. Para remover também a instalação e as chaves:

rm -rf ~/Library/Application\ Support/minhas-pastas
pra usar Clona e usa

Está tudo lá: a skill, o modelo instalável e a licença MIT.

github.com/drudif/faca-suas-pastas-magicas