Como instalar skills no Codex

Uma skill organiza um procedimento que você quer repetir com o agente. Comece com uma tarefa pequena: revisar um formulário, documentar uma decisão ou planejar um recurso.

1. Escolha a skill e o projeto

Leia a fonte, verifique dependências e abra o repositório correto no Codex. Para uma primeira experiência, prefira instalar apenas no projeto.

2. Instale pelo terminal

Com Node.js e npm disponíveis, este exemplo usa o instalador independente Skills CLI da Vercel:

npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a codex

Confira as escolhas do instalador antes de confirmar. Para listar as opções do repositório, use npx skills add vercel-labs/agent-skills --list.

3. Confira a descoberta

O Codex lê skills de projeto em .agents/skills. Cada pasta contém um SKILL.md com nome, descrição e instruções. Na CLI ou extensão de IDE, você pode usar /skills ou mencionar o nome com $. Se a skill recém-adicionada não aparecer, reinicie o Codex.

4. Faça um primeiro pedido

Use web-design-guidelines para revisar o formulário de contato. Liste problemas de teclado, rótulos e foco. Não altere arquivos nesta primeira revisão.

Depois, escolha um achado, verifique-o na interface e peça uma correção pequena. Esse ciclo ajuda a perceber se a skill combina com o trabalho antes de ampliar seu uso.

Se não funcionar

Confira a pasta do projeto, o nome da skill e o arquivo instalado. Uma skill descoberta pode depender de ferramentas que ainda não estão disponíveis. Leia a mensagem concreta antes de reinstalar tudo.

Referências: documentação de skills da OpenAI e Skills CLI da Vercel.