Aller au contenu

Configurer potato-skill dans Claude Code

Installez potato-skill comme plugin de Claude Code, choisissez la portée qui décide qui reçoit le plugin et approuvez les commandes que le skill exécute.

Claude Code installe potato-skill comme plugin, avec /plugin marketplace add davidjurgens/potato-skill suivi de /plugin install potato-skill@potato. Le plugin ajoute un seul skill, sans agents, hooks ni serveurs MCP, et Claude charge le skill chaque fois qu'une demande porte sur la construction ou l'exécution d'une étude d'annotation. potato-skill a été écrit pour Claude Code, et cette voie offre toutes les parties du skill telles qu'elles ont été conçues. 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 Claude Code 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

Installer le plugin

Dans une session Claude Code, ajoutez le marketplace puis installez le plugin.

text
/plugin marketplace add davidjurgens/potato-skill
/plugin install potato-skill@potato

La commande d'installation ouvre les détails du plugin dans le panneau /plugin et demande une portée.

PortéeQui reçoit le skillOù Claude Code enregistre le plugin
Utilisateurvous, dans tous les projets de cette machine~/.claude/settings.json
Projettoutes les personnes qui travaillent dans le dépôt.claude/settings.json, que vous commitez
Localvous, dans ce dépôt seulement.claude/settings.local.json

La portée utilisateur convient à un chercheur qui construit des études dans plusieurs dossiers de projet. La portée projet convient à un laboratoire dont les études partagent un même dépôt. Commiter .claude/settings.json active le plugin pour les collaborateurs, mais ne le télécharge pas sur leurs machines. Chaque collaborateur exécute l'installation une fois.

bash
claude plugin install potato-skill@potato --scope project

Un script de configuration peut exécuter les deux mêmes étapes depuis votre shell, sans ouvrir de session.

bash
claude plugin marketplace add davidjurgens/potato-skill
claude plugin install potato-skill@potato

Un plugin installé depuis le shell se charge au prochain démarrage de Claude Code, ou après /reload-plugins dans une session déjà ouverte. Le terminal, les sessions locales de l'application de bureau et l'extension VS Code d'un même ordinateur lisent les mêmes fichiers de réglages. Une installation de portée utilisateur faite dans l'un des trois atteint les deux autres.

Vérifier l'installation

claude plugin list dans votre shell affiche le plugin avec sa version, sa portée et son état.

text
  ❯ potato-skill@potato
    Version: 1.2.0
    Scope: user
    Status: ✔ enabled

claude plugin details potato-skill liste un skill et aucun agent, hook ni serveur MCP. La même commande estime le coût en contexte du skill à environ 220 tokens dans chaque session, pour le nom et la description du skill, et à environ 10 900 tokens chaque fois que le skill se charge.

Démarrer une étude

Décrivez l'étude en langage courant. Claude charge le skill sans commande 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.

Je veux 200 tweets annotés en sentiment sur une échelle de 5 points, par trois annotateurs chacun, avec une page de consentement et deux contrôles d'attention. Construis la tâche et lance-la.

Les skills d'un plugin portent le nom du plugin. Taper /potato-skill:potato-skill avant la demande charge directement le skill. Taper / affiche le nom dans le menu des commandes, et /skills liste tous les skills que Claude Code a chargés.

Approuver les commandes que le skill exécute

Le skill demande à Claude de valider la configuration, de démarrer un serveur Potato, d'ouvrir la tâche dans un navigateur sans interface et d'exécuter les scripts auxiliaires du skill. Chacune de ces actions est une commande shell. Dans le mode Manual par défaut, Claude Code demande avant d'exécuter une commande shell, et répondre « Yes, and don't ask again » enregistre une règle pour cette commande dans ce dépôt.

La construction d'une étude exécute potato validate et potato preview à de nombreuses reprises. Des règles allow dans .claude/settings.json approuvent d'avance ces deux commandes et laissent tout le reste à une demande de confirmation.

json
{
  "permissions": {
    "allow": [
      "Bash(potato validate *)",
      "Bash(potato preview *)"
    ]
  }
}

/permissions affiche toutes les règles et le fichier de réglages dont chacune provient. potato-skill ne déclare aucun allowed-tools. Toute commande que le skill demande passe par vos réglages de permissions. La documentation des permissions de Claude Code décrit la syntaxe des règles et les autres modes de permission.

Installer sans le système de plugins

La CLI skills place les mêmes fichiers dans .claude/skills/potato-skill/ de votre projet, où Claude Code lit les skills de projet.

bash
npx skills add davidjurgens/potato-skill --agent claude-code

Un skill de projet est nommé sans préfixe de plugin, si bien que /potato-skill charge le skill. Commiter .claude/skills/ donne le skill aux collaborateurs sans étape d'installation. Cursor, GitHub Copilot dans VS Code et OpenCode lisent aussi .claude/skills/. La CLI exige Node.js 22.20 ou une version ultérieure. Les sessions cloud de Claude Code ne chargent pas les plugins installés sur votre propre machine. Le navigateur à l'adresse claude.ai/code exécute les sessions cloud.

Mettre à jour et supprimer le plugin

Claude Code met un plugin à jour automatiquement seulement si le marketplace du plugin a la mise à jour automatique activée, et celle-ci est désactivée pour un marketplace ajouté à la main, comme davidjurgens/potato-skill. Mettez le plugin à jour depuis votre shell.

bash
claude plugin update potato-skill@potato

Pour mettre à jour automatiquement, exécutez /plugin, ouvrez l'onglet Marketplaces, sélectionnez potato et choisissez Enable auto-update. Une session en cours garde la version qu'elle a chargée, et la session suivante charge la nouvelle.

claude plugin uninstall potato-skill@potato supprime le plugin. /plugin marketplace remove potato supprime le marketplace et tous les plugins installés depuis lui. La documentation des plugins de Claude Code décrit le panneau /plugin en détail.

Pour aller plus loin