Configurer potato-skill dans Codex
Ajoutez potato-skill à un projet Codex avec une seule commande npx, lancez le skill avec $potato-skill et approuvez les commandes que le sandbox par défaut retient.
Codex lit les skills dans .agents/skills/ de votre dépôt, et npx skills add davidjurgens/potato-skill --agent codex y copie potato-skill. Codex détecte le skill sans redémarrage, et $potato-skill lance le skill dans la CLI et dans l'extension d'IDE. Démarrage rapide avec un agent de programmation explique ce que le skill fait d'une étude, et Installer potato-skill dans votre agent de programmation couvre les autres agents.
Avant d'installer
Potato s'installe dans l'environnement Python que le shell de Codex utilise. Les scripts auxiliaires du skill importent les registres de Potato et appellent la commande potato, et la première étape du skill vérifie que Potato s'importe. L'extra navigateur et Chromium permettent à potato preview --screenshot et au script de parcours du skill d'ouvrir la tâche dans un navigateur sans interface.
pip install 'potato-annotation[preview]'
playwright install chromiumLe sandbox par défaut de Codex n'a pas d'accès au réseau. Installez les deux avant de commencer pour économiser un tour d'approbations. La CLI skills s'exécute avec npx et exige Node.js 22.20 ou une version ultérieure.
Installer le skill
Exécutez l'installation dans votre dépôt.
npx skills add davidjurgens/potato-skill --agent codexLa commande copie SKILL.md, les 30 fichiers de référence et les neuf scripts auxiliaires dans .agents/skills/potato-skill/, et enregistre la source dans skills-lock.json à la racine du dépôt. Codex parcourt .agents/skills/ dans chaque dossier depuis le dossier courant jusqu'à la racine du dépôt, si bien qu'une session démarrée dans un sous-dossier du dépôt trouve aussi le skill. Commiter .agents/skills/ donne le skill aux collaborateurs sans étape d'installation.
Ajoutez -g pour installer le skill dans tous les dépôts de la machine.
npx skills add davidjurgens/potato-skill --agent codex -gUne installation globale va dans ~/.agents/skills/potato-skill/, le dossier de skills utilisateur que Codex lit. Codex détecte un nouveau skill sans redémarrage. Si le skill n'apparaît pas, redémarrez Codex.
Vérifier l'installation
Dans Codex CLI ou l'extension d'IDE, /skills liste les skills que Codex a trouvés, et potato-skill figure dans la liste. Dans l'application de bureau ChatGPT, Skills dans la barre latérale affiche les skills de tous vos projets.
Démarrer une étude
Mentionnez le skill avec $potato-skill et décrivez l'étude.
$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 charge aussi le skill sans mention lorsqu'une demande correspond à la description du skill, par exemple une demande de construire une tâche d'annotation, de modifier un config.yaml de Potato ou de suivre une étude en cours.
Sandbox et approbations
Codex exécute les commandes dans un sandbox. Le mode par défaut, workspace-write, permet aux commandes d'écrire dans l'espace de travail avec l'accès au réseau désactivé. Le réglage qui commande le réseau est sandbox_workspace_write.network_access, dont la valeur par défaut est false. Avec la politique d'approbation on-request, Codex travaille dans le sandbox et demande avant d'exécuter une commande qui sort du sandbox.
Pendant une construction, le skill fait valider la configuration par Codex, démarrer un serveur Potato sur votre machine, ouvrir la tâche dans un navigateur sans interface et exécuter les scripts auxiliaires du skill. Un pip install a besoin du réseau, et le sandbox par défaut n'en a pas. Approuvez une commande hors du sandbox lorsque Codex le demande, après avoir lu la commande. Dans la CLI, /permissions ouvre le sélecteur de permissions. Dans l'extension d'IDE et dans l'application, les mêmes choix se trouvent sous la zone de saisie sous les noms Ask for approval, Approve for me et Full access. La documentation du sandbox de Codex décrit chaque mode.
AGENTS.md
Codex lit AGENTS.md d'après son nom de fichier. Le dépôt de potato-skill contient un AGENTS.md à la racine, un court résumé des règles du skill. Copier ce fichier à la racine de votre dépôt donne les règles à Codex sans étape d'installation. Le fichier renvoie à des fichiers de référence et à des scripts que seule une installation complète dépose sur le disque. Utilisez l'installation avec la CLI skills pour construire une étude. Si votre dépôt contient déjà un AGENTS.md, ajoutez le résumé à ce fichier au lieu de le remplacer.
Mettre à jour et supprimer le skill
La CLI skills met à jour et supprime le skill par son nom. Ajoutez -g à l'une ou l'autre commande pour une installation globale.
npx skills update potato-skill
npx skills remove potato-skillupdate compare la copie installée au dépôt GitHub et remplace la copie lorsque le dépôt a changé. remove supprime .agents/skills/potato-skill/ et l'entrée du skill dans skills-lock.json.
Pour désactiver le skill sans le supprimer, ajoutez une entrée à ~/.codex/config.toml avec le chemin absolu du SKILL.md du skill, puis redémarrez Codex. La documentation des skills de Codex liste les autres réglages qu'accepte une entrée.
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false