Como adicionar skills no Codex

O Codex (e o ChatGPT, na mesma página de autoria de skills) carrega uma pasta com SKILL.md. name e description são obrigatórios. Esta página usa só os locais da documentação Codex Build skills.

Comece por Codex Build skills.

Leia developers.openai.com/codex/skills. Uma skill é um diretório com SKILL.md mais scripts e referências opcionais. ChatGPT e Codex ativam uma skill quando você a menciona ou quando a tarefa corresponde à descrição.

No Codex CLI ou na extensão da IDE, execute /skills ou digite $ para mencionar uma skill. No ChatGPT, digite @ para selecionar uma skill.

Onde o Codex carrega skills locais.

Dessa página:

  • Repositório: .agents/skills do diretório de trabalho atual até a raiz do repositório
  • Usuário: $HOME/.agents/skills
  • Admin: /etc/codex/skills

Essa documentação não lista uma pasta ~/.codex/skills como caminho de carga do Codex. Use .agents/skills (ou o home do usuário .agents/skills) como está escrito. Plugins distribuem skills reutilizáveis além de um repositório. $skill-installer instala skills curadas para uso local.

Adicione uma skill da Tiny Design Shop.

Pegue a pasta em uma companheira ou no GitHub e coloque-a em .agents/skills/<pack>/ no repositório ou em $HOME/.agents/skills/. O Codex detecta mudanças automaticamente; reinicie o Codex se uma atualização não aparecer.

Confirme que carregou.

Execute /skills ou mencione a skill com $. Para desativar sem apagar, a documentação mostra [[skills.config]] em ~/.codex/config.toml com enabled = false e um caminho para esse SKILL.md.