Vai al contenuto

Configurare potato-skill in Claude Code

Installa potato-skill come plugin di Claude Code, scegli l'ambito che decide chi riceve il plugin e approva i comandi che la skill esegue.

Claude Code installa potato-skill come plugin, con /plugin marketplace add davidjurgens/potato-skill seguito da /plugin install potato-skill@potato. Il plugin aggiunge una sola skill, senza agenti, hook o server MCP, e Claude carica la skill ogni volta che una richiesta riguarda la costruzione o l'esecuzione di uno studio di annotazione. potato-skill è stata scritta per Claude Code, e questa strada offre ogni parte della skill come progettata. potato-skill: costruire uno studio di annotazione con un coding agent descrive che cosa fa la skill con uno studio, e Installare potato-skill nel tuo agente di programmazione tratta gli altri agenti.

Prima di installare

Potato va installato nell'ambiente Python che usa la shell di Claude Code. Gli script di supporto della skill importano i registri di Potato e chiamano il comando potato, e il primo passo della skill verifica che Potato si importi. L'extra per il browser e Chromium permettono a potato preview --screenshot e allo script di verifica guidata della skill di aprire il task in un browser headless:

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

Installare il plugin

In una sessione di Claude Code, aggiungi il marketplace e poi installa il plugin:

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

Il comando di installazione apre i dettagli del plugin nel pannello /plugin e chiede un ambito:

AmbitoChi riceve la skillDove Claude Code registra il plugin
Utentetu, in ogni progetto di questa macchina~/.claude/settings.json
Progettochiunque lavori nel repository.claude/settings.json, di cui fai il commit
Localetu, solo in questo repository.claude/settings.local.json

L'ambito Utente si adatta a un ricercatore che costruisce studi in più cartelle di progetto. L'ambito Progetto si adatta a un laboratorio i cui studi condividono un solo repository. Fare il commit di .claude/settings.json attiva il plugin per i collaboratori ma non scarica il plugin sulle loro macchine. Ogni collaboratore esegue l'installazione una volta:

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

Uno script di configurazione può eseguire gli stessi due passi dalla shell senza aprire una sessione:

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

Un plugin installato dalla shell viene caricato al successivo avvio di Claude Code, oppure dopo /reload-plugins in una sessione già aperta. Il terminale, le sessioni locali dell'app desktop e l'estensione VS Code sullo stesso computer leggono gli stessi file di impostazioni. Un'installazione con ambito Utente in uno dei tre raggiunge gli altri due.

Verificare l'installazione

claude plugin list nella shell stampa il plugin con la sua versione, il suo ambito e il suo stato:

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

claude plugin details potato-skill elenca una skill e nessun agente, hook o server MCP. Lo stesso comando stima il costo della skill in contesto in circa 220 token in ogni sessione, per il nome e la descrizione della skill, e in circa 10.900 token ogni volta che la skill viene caricata.

Avviare uno studio

Descrivi lo studio in linguaggio naturale. Claude carica la skill senza un comando quando una richiesta corrisponde alla descrizione della skill, per esempio la richiesta di costruire un task di annotazione, modificare un config.yaml di Potato o controllare uno studio in corso:

Voglio che 200 tweet vengano etichettati per sentiment su una scala a 5 punti da tre annotatori ciascuno, con una pagina di consenso e due controlli di attenzione. Costruiscilo e avvialo.

Le skill dei plugin prendono il nome dal loro plugin. Digitare /potato-skill:potato-skill prima della richiesta carica direttamente la skill. Digitare / mostra il nome nel menu dei comandi, e /skills elenca ogni skill che Claude Code ha caricato.

Approvare i comandi che la skill esegue

La skill chiede a Claude di validare la configurazione, avviare un server Potato, aprire il task in un browser headless ed eseguire gli script di supporto della skill. Ognuno di questi è un comando di shell. Nella modalità Manual predefinita, Claude Code chiede conferma prima di eseguire un comando di shell, e rispondere "Yes, and don't ask again" salva una regola per quel comando in quel repository.

La costruzione di uno studio esegue potato validate e potato preview molte volte. Le regole allow in .claude/settings.json approvano in anticipo questi due comandi e lasciano tutto il resto a una richiesta di conferma:

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

/permissions mostra ogni regola e il file di impostazioni da cui proviene. potato-skill non dichiara allowed-tools. Ogni comando che la skill richiede passa attraverso le tue impostazioni dei permessi. La documentazione dei permessi di Claude Code descrive la sintassi delle regole e le altre modalità di permesso.

Installare senza il sistema di plugin

La CLI skills mette gli stessi file in .claude/skills/potato-skill/ nel tuo progetto, dove Claude Code legge le skill di progetto:

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

Una skill di progetto ha un nome senza prefisso del plugin, quindi /potato-skill carica la skill. Fare il commit di .claude/skills/ dà la skill ai collaboratori senza alcun passo di installazione. Anche Cursor, GitHub Copilot in VS Code e OpenCode leggono .claude/skills/. La CLI richiede Node.js 22.20 o successivo. Le sessioni cloud di Claude Code non caricano i plugin installati sulla tua macchina. Le sessioni cloud girano nel browser, su claude.ai/code.

Aggiornare e rimuovere il plugin

Claude Code aggiorna un plugin automaticamente solo quando il marketplace del plugin ha l'aggiornamento automatico attivo, e l'aggiornamento automatico parte disattivato per un marketplace aggiunto a mano, come davidjurgens/potato-skill. Aggiorna il plugin dalla shell:

bash
claude plugin update potato-skill@potato

Per aggiornare invece in automatico, esegui /plugin, apri la scheda Marketplaces, seleziona potato e scegli Enable auto-update. Una sessione in corso mantiene la versione che ha caricato, e la sessione successiva carica quella nuova.

claude plugin uninstall potato-skill@potato rimuove il plugin. /plugin marketplace remove potato rimuove il marketplace e ogni plugin installato da quel marketplace. La documentazione dei plugin di Claude Code descrive il pannello /plugin per intero.

Ulteriori letture