Skills no Codex: como instalar e usar a pasta .agents/skills

A melhor notícia de 2026: o formato SKILL.md virou padrão nos dois lados

Quando comecei a montar a minha biblioteca de skills na agência, meu maior receio era ficar refém de uma empresa só e ter que reescrever tudo se outro agente ficasse melhor ou mais barato. Felizmente, o mercado convergiu para o mesmo formato aberto: tanto o Claude Code quanto o Codex e o Antigravity leem subpastas contendo um arquivo principal chamado SKILL.md, com cabeçalho em YAML (name e description) seguido das instruções em Markdown.

No Codex, em qualquer um dos quatro lugares onde ele roda (no app do ChatGPT pro computador (Mac e Windows; no Linux, em prévia), no terminal (o Codex CLI), na extensão do editor de código, na web, na nuvem (o Codex Cloud) e no app do ChatGPT no celular), o agente varre automaticamente a pasta a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto) dentro do seu projeto ou da sua pasta de usuário, além de ler o arquivo AGENTS.md na raiz. Olha na documentação oficial da OpenAI como a estrutura é exatamente essa:

Onde cada ferramenta procura as suas skills: a tabela para colar na parede

Para você nunca mais se confundir na hora de abrir um projeto no computador, a diferença entre os principais agentes do mercado está apenas no nome da pasta oculta na raiz do projeto e no nome do arquivo geral de regras. O conteúdo lá dentro é idêntico:

Como ficam os arquivos AGENTS.md e SKILL.md por dentro

Gosto de pensar no AGENTS.md como o quadro de avisos na parede da oficina e em cada pasta dentro de a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto) como um manual especializado que o agente só abre quando precisa daquela habilidade. Se você jogar quinhentas linhas de regras misturadas dentro do AGENTS.md, o modelo (o GPT-6.1 Sol, lançado em 29/09/2026, que a OpenAI manda usar no Plus, no Pro e nos planos de empresa (no Free e no Go, o GPT-6 Luna, no app de computador)) gasta janela de contexto à toa em toda pergunta simples.

Por isso, no AGENTS.md você deixa só o que vale para qualquer tarefa naquele projeto, e nas subpastas de skills você separa a direção de arte, a escrita de copy, a auditoria de celular e o envio para o ar. Veja um exemplo enxuto de como fica um arquivo .agents/skills/direcao-visual/SKILL.md que o Codex entende na hora:

Passo a passo: como usar a mesma pasta de skills no Codex e no Claude Code

Se você alterna entre o Codex e o Claude Code (como mostro no comparativo Codex vs Claude Code e na análise da melhor IA para programar) ou se já aprendeu como instalar skills no padrão da Anthropic, você não precisa duplicar arquivos manualmente toda vez que editar uma instrução. Basta seguir este roteiro de três passos:

1. 11. Crie a pasta .agents/skills na raiz do seu projeto: dentro da pasta onde vai nascer o site do seu cliente, crie a pasta .agents e, dentro dela, a subpasta skills. Cada skill deve ficar na sua própria pastinha com o arquivo SKILL.md lá dentro.
2. 22. Espelhe para o Claude Code ou Antigravity se usar mais de um agente: se você também abre a mesma pasta no Claude Code, basta copiar o conteúdo de .agents/skills para .claude/skills (ou criar um atalho simbólico com ln -s ../.agents/skills .claude/skills no Mac e Linux). No MazyOS, nós já entregamos o pacote organizado para todas essas ferramentas.
3. 33. Chame pelo cifrão ($) ou deixe o Codex acionar sozinho: com a pasta no lugar, abra o Codex no app do ChatGPT, no VS Code ou no terminal. Você pode digitar $ na caixa de pedido pra ver a lista de skills carregadas e escolher uma (no VS Code e no terminal, o comando /skills abre a mesma lista) ou simplesmente pedir em português para criar a página, porque o Codex lê o campo description de cada skill e aciona a certa automaticamente.

As melhores skills pro Codex

Como o Codex segue o padrão aberto, a maioria das skills do Shopping de skills roda nele sem mudar uma linha. Separei as que mais ajudam quem cria site e conteúdo pros clientes, e de cada uma digo por que ela roda no Codex:

• brainstorming skill, do Superpowers: antes de sair codando, o agente entende o que você quer, mostra duas ou três formas de fazer e só começa depois do seu ok. O Superpowers inteiro tá no marketplace oficial de plugins do Codex, e o resto dele tá no guia do Superpowers.
• grill-me skill, do Matt Pocock: te interroga sobre o plano, rodada por rodada, até não sobrar decisão no ar. O pacote dele tem instalação própria pro Codex.
• ui-ux-pro-max skill: um banco de paletas, pares de fontes e regras de UX que o agente consulta antes de desenhar, escolhendo pelo tipo do negócio. O instalador dela tem a opção do Codex CLI.
• impeccable skill: põe o agente pra projetar, criticar e dar acabamento na tela, de landing page a painel. No Codex, depois de instalar, você abre o /hooks e aprova o gatilho de design do projeto.
• copywriting skill, do Corey Haines: escreve título, subtítulo, botão e cada seção da página, com opções pra testar e sem promessa que você não consegue provar. O pacote de marketing dele tem plugin pro Codex.
• humanizer skill: tira a cara de IA do texto sem mudar o que ele diz. O próprio repositório avisa que ela funciona no Codex.
• remotion-best-practices skill: faz vídeo com código, no Remotion, com a prévia aberta no navegador antes de exportar o MP4. O Remotion diz que as skills dele servem pro Codex.
• caveman skill: o agente responde curto, sem saudação nem resumo no fim, e gasta menos token, o que ajuda a esticar o limite do Codex. No Codex, você liga com $caveman.
• find-skills skill, da Vercel: quando você pergunta se tem skill pra uma tarefa, ela procura, mostra quantas instalações a skill tem e de onde vem, e instala com o npx skills, que também põe skill no Codex.

Pra instalar qualquer uma, a página dela no shopping tem o comando. Quando ele é o npx skills add, que é o caso da maioria, acrescente -a codex no fim, que a skill vai só pra pasta .agents/skills do Codex. Outro jeito é pedir pro $skill-installer, que já vem no Codex e baixa skill de um repositório do GitHub. Se a skill nova não aparecer na lista do $, feche e abra o Codex de novo.

Por que são as skills que tiram a cara de site genérico do Codex

Qualquer pessoa que já tentou criar site com IA no Codex sem nenhuma pasta de instruções percebeu na hora o que acontece: o código funciona tecnicamente, não dá erro no terminal, mas a página parece um painel administrativo dos anos 2010 sem alma comercial. O modelo é treinado para resolver problemas lógicos de engenharia, não para pensar como diretor de arte ou redator de resposta direta.

Quando você abastece a pasta a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto) com skills focadas em pesquisa de público, construção de oferta, tipografia editorial, revisão de telas móveis e preparação para hospedar o site, o mesmo Codex muda da água para o vinho. Ele passa a perguntar os diferenciais do negócio local, escolhe espaçamentos que passam confiança e entrega um site que o empresário tem gosto de pagar.

Foi exatamente esse conjunto de 17 skills prontas que roda no Claude Code, no Codex e no Antigravity que eu reuni dentro do MazyOS (R$ 97 por um ano ou R$ 197 pra sempre). E quando o seu projeto salta aos olhos do cliente logo na primeira apresentação, o resultado financeiro aparece rápido. Olha o print que o Amaro Mendes mandou na nossa comunidade batendo R$ 5.807,96 em vendas de sites:

Dica final: onde guardar skills que você usa em todo projeto novo

Além da pasta a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto) dentro de cada projeto individual, o Codex também aceita que você guarde as suas skills favoritas na pasta principal do seu usuário no computador (~/.agents/skills). Tudo o que estiver ali fica disponível automaticamente em qualquer projeto novo que você abrir no aplicativo do ChatGPT ou no terminal, economizando ainda mais tempo a cada cliente fechado.

Perguntas sobre skills no Codex

Qual é o nome exato da pasta de skills no OpenAI Codex? O Codex procura as skills dentro da pasta a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto) na raiz do projeto (ou em ~/.agents/skills na pasta do seu usuário). Cada skill fica em uma subpasta própria contendo um arquivo SKILL.md.

As skills feitas para o Claude Code funcionam no Codex? Sim, o formato interno do arquivo SKILL.md (cabeçalho YAML com name e description mais instruções em Markdown) é exatamente o mesmo. Basta colocar as pastas das skills dentro de a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto) para o Codex reconhecê-las.

Qual é a diferença entre o arquivo AGENTS.md e a pasta .agents/skills? O arquivo AGENTS.md fica na raiz do projeto e é lido inteiro em toda conversa, sendo ideal para regras curtas e gerais. Já as pastas dentro de a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto) são carregadas sob demanda apenas quando a tarefa pede aquela especialidade, economizando a janela de contexto do modelo.

O Codex no aplicativo do ChatGPT também lê a pasta .agents/skills? Sim. Tanto o aplicativo do ChatGPT para computador quanto a extensão do VS Code, o terminal (@openai/codex) e o ambiente na nuvem leem automaticamente a pasta a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto) do projeto.

As 17 skills do MazyOS já vêm prontas para usar no Codex? Sim. Ao entrar no MazyOS (R$ 97 por um ano ou R$ 197 pra sempre), você baixa o pacote com as 17 skills já formatadas para jogar direto na pasta do seu projeto e usar no Codex, Claude Code, Antigravity, OpenCode ou Cursor.