Installare potato-skill nel tuo agente di programmazione
Installa potato-skill in Claude Code, Codex, Cursor o in un altro agente di programmazione, con il comando di installazione e la cartella delle skill di ciascun agente.
potato-skill è una Agent Skill, una cartella di istruzioni e script di supporto che qualsiasi agente di programmazione che supporti il formato può caricare. Claude Code installa potato-skill come plugin, mentre ogni altro agente ottiene la cartella da npx skills add davidjurgens/potato-skill, con il nome dell'agente dopo --agent. Claude Code, Codex e Cursor hanno ciascuno una pagina di configurazione dedicata. potato-skill: costruire uno studio di annotazione con un coding agent descrive che cosa fa la skill con uno studio.
Comandi di installazione per agente
| Agente | Installazione | Cartella che l'agente legge | Pagina di configurazione |
|---|---|---|---|
| Claude Code | /plugin marketplace add davidjurgens/potato-skill, poi /plugin install potato-skill@potato | La cache dei plugin di Claude Code | Claude Code |
| Codex | npx skills add davidjurgens/potato-skill --agent codex | .agents/skills/ | Codex |
| Cursor | npx skills add davidjurgens/potato-skill --agent cursor | .agents/skills/ | Cursor |
| GitHub Copilot in VS Code | npx skills add davidjurgens/potato-skill --agent github-copilot | .agents/skills/ | sotto |
| Gemini CLI | npx skills add davidjurgens/potato-skill --agent gemini-cli | .agents/skills/ | sotto |
| OpenCode | npx skills add davidjurgens/potato-skill --agent opencode | .agents/skills/ | sotto |
potato-skill è stata scritta per Claude Code, e il SKILL.md della skill indica anche le cartelle di installazione per Codex e Cursor. GitHub Copilot, Gemini CLI e OpenCode caricano gli stessi file. Apri nel browser il primo task che un agente costruisce e etichetta tu stesso qualche item prima di invitare gli annotatori.
Prima di installare
Potato va installato nell'ambiente Python che usa la shell dell'agente. 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:
pip install 'potato-annotation[preview]'
playwright install chromiumLa CLI skills viene eseguita tramite npx. La versione 1.7.6 della CLI richiede Node.js 22.20 o successivo.
Che cosa scrive la CLI skills
npx skills add copia SKILL.md, i 30 file di riferimento e i nove script di supporto in .agents/skills/potato-skill/, e registra l'origine in skills-lock.json nella radice del progetto. Aggiungi -g per installare in ~/.agents/skills/potato-skill/, per tutti i progetti della macchina. Codex, Cursor, GitHub Copilot in VS Code, Gemini CLI e OpenCode leggono tutti .agents/skills/. Un solo comando può indicare più di questi agenti, e gli agenti condividono allora un'unica copia:
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencodeLa tabella degli agenti della CLI riporta il nome per --agent e la cartella degli altri agenti che la CLI supporta. Ogni agente di questa pagina carica la skill anche senza un comando, quando una richiesta corrisponde alla descrizione della skill, per esempio la richiesta di costruire un task di annotazione.
GitHub Copilot in VS Code
VS Code legge .agents/skills/ e .claude/skills/ nelle sessioni locali, accanto a .github/skills/ di Copilot. Le skill funzionano sia nella chat sia nella modalità agente. Digitare /potato-skill nella chat avvia la skill.
Gemini CLI
Gemini CLI legge .agents/skills/ nell'area di lavoro e ~/.agents/skills/ per l'utente. /skills list mostra le skill che Gemini ha trovato. Gemini avvia una skill pertinente senza un comando, e chiede conferma prima di caricarla nella conversazione.
OpenCode
OpenCode legge .agents/skills/ in ogni cartella, da quella corrente fino al worktree git, e ~/.agents/skills/ per un'installazione globale. L'agente carica una skill pertinente tramite lo strumento skill di OpenCode.
Senza la CLI skills
Il repository di potato-skill ha un AGENTS.md nella radice, un breve riepilogo delle regole della skill che Codex e Cursor leggono per nome di file. Copiare il file nella radice del progetto dà all'agente le regole senza alcun passo di installazione. Il file rimanda a file di riferimento e script che solo un'installazione completa mette su disco. La potato-skill: costruire uno studio di annotazione con un coding agent confronta l'installazione completa con la copia di AGENTS.md. I file di riferimento sono pubblicati anche su davidjurgens.github.io/potato-skill. Un agente che sa leggere pagine web può usare la copia pubblicata, e puoi leggere lì i file prima di installare.
Aggiornare e rimuovere la skill
La CLI skills aggiorna e rimuove la skill per nome. Aggiungi -g a entrambi i comandi per un'installazione globale:
npx skills update potato-skill
npx skills remove potato-skillupdate confronta la copia installata con il repository GitHub e sostituisce la copia quando il repository è cambiato. remove elimina .agents/skills/potato-skill/ e la voce della skill in skills-lock.json. La pagina di Claude Code riporta i comandi di aggiornamento e rimozione del plugin.