Aller au contenu

Installer potato-skill dans votre agent de programmation

Installez potato-skill dans Claude Code, Codex, Cursor ou un autre agent de programmation, avec la commande d'installation et le dossier de skills de chaque agent.

potato-skill est une Agent Skill, un dossier d'instructions et de scripts auxiliaires que tout agent de programmation compatible avec le format peut charger. Claude Code installe potato-skill comme plugin, et tous les autres agents obtiennent le dossier avec npx skills add davidjurgens/potato-skill, le nom de l'agent suivant --agent. Claude Code, Codex et Cursor ont chacun une page de configuration propre. Démarrage rapide avec un agent de programmation explique ce que le skill fait d'une étude.

Commandes d'installation par agent

AgentInstallationDossier que l'agent litPage de configuration
Claude Code/plugin marketplace add davidjurgens/potato-skill, puis /plugin install potato-skill@potatoLe cache de plugins de Claude CodeClaude Code
Codexnpx skills add davidjurgens/potato-skill --agent codex.agents/skills/Codex
Cursornpx skills add davidjurgens/potato-skill --agent cursor.agents/skills/Cursor
GitHub Copilot dans VS Codenpx skills add davidjurgens/potato-skill --agent github-copilot.agents/skills/ci-dessous
Gemini CLInpx skills add davidjurgens/potato-skill --agent gemini-cli.agents/skills/ci-dessous
OpenCodenpx skills add davidjurgens/potato-skill --agent opencode.agents/skills/ci-dessous

potato-skill a été écrit pour Claude Code, et le SKILL.md du skill nomme aussi les dossiers d'installation de Codex et de Cursor. GitHub Copilot, Gemini CLI et OpenCode chargent les mêmes fichiers. Ouvrez dans votre navigateur la première tâche qu'un agent construit et étiquetez vous-même quelques items avant d'inviter des annotateurs.

Avant d'installer

Potato s'installe dans l'environnement Python que le shell de l'agent 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.

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

La CLI skills s'exécute avec npx. La version 1.7.6 de la CLI exige Node.js 22.20 ou une version ultérieure.

Ce qu'écrit la CLI skills

npx skills add 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 projet. Ajoutez -g pour installer dans ~/.agents/skills/potato-skill/ pour tous les projets de la machine. Codex, Cursor, GitHub Copilot dans VS Code, Gemini CLI et OpenCode lisent tous .agents/skills/. Une seule commande peut nommer plusieurs de ces agents, et les agents partagent alors une seule copie.

bash
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencode

Le tableau des agents de la CLI donne le nom pour --agent et le dossier des autres agents que la CLI prend en charge. Chaque agent de cette page charge aussi le skill sans commande lorsqu'une demande correspond à la description du skill, par exemple une demande de construire une tâche d'annotation.

GitHub Copilot dans VS Code

VS Code lit .agents/skills/ et .claude/skills/ dans les sessions locales, à côté de .github/skills/, le dossier propre à Copilot. Les skills fonctionnent dans le chat comme en mode agent. Taper /potato-skill dans le chat lance le skill.

Gemini CLI

Gemini CLI lit .agents/skills/ dans l'espace de travail et ~/.agents/skills/ pour l'utilisateur. /skills list affiche les skills que Gemini a trouvés. Gemini lance un skill correspondant sans commande, et vous demande de confirmer avant de charger le skill dans la conversation.

OpenCode

OpenCode lit .agents/skills/ dans chaque dossier depuis le dossier courant jusqu'au worktree git, et ~/.agents/skills/ pour une installation globale. L'agent charge un skill correspondant par l'outil skill d'OpenCode.

Sans la CLI skills

Le dépôt de potato-skill contient un AGENTS.md à la racine, un court résumé des règles du skill que Codex et Cursor lisent d'après son nom de fichier. Copier le fichier à la racine de votre projet donne les règles à un agent 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. Le Démarrage rapide avec un agent de programmation compare l'installation complète à la copie de AGENTS.md. Les fichiers de référence sont aussi publiés à l'adresse davidjurgens.github.io/potato-skill. Un agent capable de lire des pages web peut utiliser la copie publiée, et vous pouvez lire les fichiers sur cette page avant d'installer.

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.

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

update 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. La page Claude Code donne les commandes de mise à jour et de suppression du plugin.

Pour aller plus loin