Ir al contenido

Configurar potato-skill en Codex

Añade potato-skill a un proyecto de Codex con un solo comando npx, inicia la skill con $potato-skill y aprueba los comandos que el sandbox predeterminado retiene.

Codex lee las skills de .agents/skills/ en tu repositorio, y npx skills add davidjurgens/potato-skill --agent codex copia potato-skill allí. Codex detecta la skill sin reiniciarse, y $potato-skill inicia la skill en la CLI y en la extensión del IDE. Inicio rápido con un agente de programación explica qué hace la skill con un estudio, y Instalar potato-skill en tu agente de programación cubre los demás agentes.

Antes de instalar

Potato se instala en el entorno de Python que usa el shell de Codex. Los scripts auxiliares de la skill importan los registros de Potato y llaman al comando potato, y el primer paso de la skill comprueba que Potato se importa. El extra de navegador y Chromium permiten que potato preview --screenshot y el script de recorrido de la skill abran la tarea en un navegador sin interfaz.

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

El sandbox predeterminado de Codex no tiene acceso a la red. Instala ambos antes de empezar para ahorrarte una ronda de aprobaciones. La CLI skills se ejecuta con npx y necesita Node.js 22.20 o posterior.

Instalar la skill

Ejecuta la instalación en tu repositorio.

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

El comando copia SKILL.md, los 30 archivos de referencia y los nueve scripts auxiliares en .agents/skills/potato-skill/, y registra el origen en skills-lock.json en la raíz del repositorio. Codex examina .agents/skills/ en todas las carpetas desde la actual hasta la raíz del repositorio, de modo que una sesión iniciada en una subcarpeta del repositorio también encuentra la skill. Subir .agents/skills/ al repositorio da la skill a los colaboradores sin ningún paso de instalación.

Añade -g para instalar la skill en todos los repositorios de la máquina.

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

Una instalación global va a ~/.agents/skills/potato-skill/, la carpeta de skills de usuario que lee Codex. Codex detecta una skill nueva sin reiniciarse. Si la skill no aparece, reinicia Codex.

Comprobar la instalación

En Codex CLI o en la extensión del IDE, /skills enumera las skills que Codex encontró, y potato-skill aparece en la lista. En la aplicación de escritorio de ChatGPT, Skills en la barra lateral muestra las skills de todos tus proyectos.

Empezar un estudio

Menciona la skill con $potato-skill y describe el estudio.

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.

Codex también carga la skill sin mención cuando una petición coincide con la descripción de la skill, por ejemplo una petición de construir una tarea de anotación, editar un config.yaml de Potato o consultar un estudio en marcha.

Sandbox y aprobaciones

Codex ejecuta los comandos en un sandbox. El modo predeterminado, workspace-write, permite que los comandos escriban dentro del espacio de trabajo con el acceso a la red desactivado. El ajuste que controla la red es sandbox_workspace_write.network_access, que por defecto vale false. Con la política de aprobación on-request, Codex trabaja dentro del sandbox y pregunta antes de ejecutar un comando que sale del sandbox.

Durante una construcción, la skill hace que Codex valide la configuración, inicie un servidor de Potato en tu máquina, abra la tarea en un navegador sin interfaz y ejecute los scripts auxiliares de la skill. Un pip install necesita la red, y el sandbox predeterminado no la tiene. Cuando Codex lo pida, aprueba un comando fuera del sandbox después de leerlo. En la CLI, /permissions abre el selector de permisos. En la extensión del IDE y en la aplicación, las mismas opciones están bajo el cuadro de texto como Ask for approval, Approve for me y Full access. La documentación del sandbox de Codex describe cada modo.

AGENTS.md

Codex lee AGENTS.md por su nombre de archivo. El repositorio de potato-skill tiene un AGENTS.md en la raíz, un resumen breve de las reglas de la skill. Copiar ese archivo en la raíz de tu repositorio da las reglas a Codex sin ningún paso de instalación. El archivo remite a archivos de referencia y scripts que solo una instalación completa deja en el disco. Usa la instalación con la CLI skills para construir un estudio. Si tu repositorio ya tiene un AGENTS.md, añade el resumen a ese archivo en lugar de reemplazarlo.

Actualizar y eliminar la skill

La CLI skills actualiza y elimina la skill por su nombre. Añade -g a cualquiera de los dos comandos para una instalación global.

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

update compara la copia instalada con el repositorio de GitHub y reemplaza la copia cuando el repositorio ha cambiado. remove elimina .agents/skills/potato-skill/ y la entrada de la skill en skills-lock.json.

Para desactivar la skill sin borrarla, añade una entrada a ~/.codex/config.toml con la ruta absoluta del SKILL.md de la skill y reinicia Codex. La documentación de skills de Codex enumera los demás ajustes que admite una entrada.

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

Lecturas adicionales