Pular para o conteúdo

Configure o potato-skill no Codex

Adicione o potato-skill a um projeto do Codex com um único comando npx, inicie a skill com $potato-skill e aprove os comandos que o sandbox padrão bloqueia.

O Codex lê skills de .agents/skills/ no seu repositório, e npx skills add davidjurgens/potato-skill --agent codex copia o potato-skill para lá. O Codex reconhece a skill sem reiniciar, e $potato-skill inicia a skill na CLI e na extensão para IDE. potato-skill: crie um estudo de anotação com um agente de programação descreve o que a skill faz com um estudo, e Instale o potato-skill no seu agente de programação trata dos outros agentes.

Antes de instalar

O Potato vai no ambiente Python que o shell do Codex usa. Os scripts auxiliares da skill importam os registros do Potato e chamam o comando potato, e o primeiro passo da skill confere se o Potato pode ser importado. O extra de navegador e o Chromium permitem que potato preview --screenshot e o script de percurso da skill abram a tarefa em um navegador sem interface:

bash
pip install 'potato-annotation[preview]'
playwright install chromium

O sandbox padrão do Codex não tem acesso à rede. Instale os dois antes de começar para poupar uma rodada de aprovações. A skills CLI é executada pelo npx e exige o Node.js 22.20 ou posterior.

Instalando a skill

Execute a instalação no seu repositório:

bash
npx skills add davidjurgens/potato-skill --agent codex

O comando copia o SKILL.md, os 30 arquivos de referência e os nove scripts auxiliares para .agents/skills/potato-skill/, e registra a origem em skills-lock.json na raiz do repositório. O Codex varre .agents/skills/ em cada pasta, da atual até a raiz do repositório, então uma sessão iniciada em uma subpasta do repositório também encontra a skill. Fazer o commit de .agents/skills/ dá a skill aos colaboradores sem nenhum passo de instalação.

Acrescente -g para instalar a skill, em vez disso, para todos os repositórios da máquina:

bash
npx skills add davidjurgens/potato-skill --agent codex -g

Uma instalação global vai para ~/.agents/skills/potato-skill/, a pasta de skills no nível do usuário que o Codex lê. O Codex detecta uma skill nova sem reiniciar. Se a skill não aparecer, reinicie o Codex.

Conferindo a instalação

No Codex CLI ou na extensão para IDE, /skills lista as skills que o Codex encontrou, e o potato-skill aparece na lista. No aplicativo desktop do ChatGPT, Skills na barra lateral mostra as skills de todos os seus projetos.

Iniciando um estudo

Mencione a skill com $potato-skill e descreva o estudo:

text
$potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.

O Codex também carrega a skill sem uma menção quando um pedido corresponde à descrição da skill, como o pedido de construir uma tarefa de anotação, editar um config.yaml do Potato ou verificar um estudo em andamento.

Sandbox e aprovações

O Codex executa comandos em um sandbox. O modo padrão, workspace-write, permite que os comandos gravem dentro do workspace com o acesso à rede desligado. A configuração por trás da rede é sandbox_workspace_write.network_access, que por padrão é false. Sob a política de aprovação on-request, o Codex trabalha dentro do sandbox e pergunta antes de um comando que vá além do sandbox.

Durante a construção, a skill faz o Codex validar a configuração, iniciar um servidor do Potato na sua máquina, abrir a tarefa em um navegador sem interface e executar os scripts auxiliares da skill. Um pip install precisa de rede, e o sandbox padrão não tem nenhuma. Aprove um comando fora do sandbox quando o Codex perguntar, depois de ler o comando. Na CLI, /permissions abre o seletor de permissões. Na extensão para IDE e no aplicativo, as mesmas opções ficam abaixo do campo de mensagem como Ask for approval, Approve for me e Full access. A documentação de sandbox do Codex descreve cada modo.

AGENTS.md

O Codex lê o AGENTS.md pelo nome do arquivo. O repositório do potato-skill tem um AGENTS.md na raiz, um resumo curto das regras da skill. Copiar esse arquivo para a raiz do seu repositório dá ao Codex as regras sem nenhum passo de instalação. O arquivo aponta para arquivos de referência e scripts que só uma instalação completa coloca no disco. Use a instalação pela skills CLI para construir um estudo. Se o seu repositório já tem um AGENTS.md, acrescente o resumo a esse arquivo em vez de substituí-lo.

Atualizando e removendo a skill

A skills CLI atualiza e remove a skill pelo nome. Acrescente -g a qualquer um dos comandos para uma instalação global:

bash
npx skills update potato-skill
npx skills remove potato-skill

update compara a cópia instalada com o repositório do GitHub e substitui a cópia quando o repositório mudou. remove apaga .agents/skills/potato-skill/ e a entrada da skill em skills-lock.json.

Para desligar a skill sem apagá-la, acrescente uma entrada a ~/.codex/config.toml com o caminho absoluto do SKILL.md da skill e reinicie o Codex. A documentação de skills do Codex lista as outras configurações que uma entrada aceita:

toml
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false

Leitura complementar