Zum Inhalt springen

potato-skill in Claude Code einrichten

Installieren Sie potato-skill als Claude-Code-Plugin, wählen Sie den Geltungsbereich, der bestimmt, wer das Plugin erhält, und geben Sie die Befehle frei, die der Skill ausführt.

Claude Code installiert potato-skill als Plugin, mit /plugin marketplace add davidjurgens/potato-skill gefolgt von /plugin install potato-skill@potato. Das Plugin fügt einen einzigen Skill hinzu, ohne Agenten, Hooks oder MCP-Server, und Claude lädt den Skill, sobald eine Anfrage den Aufbau oder den Betrieb einer Annotationsstudie betrifft. potato-skill wurde für Claude Code geschrieben, und dieser Weg liefert jeden Teil des Skills so, wie er entworfen wurde. Schnellstart mit einem Coding-Agenten erklärt, was der Skill mit einer Studie macht, und potato-skill in Ihrem Coding-Agenten installieren behandelt die anderen Agenten.

Vor der Installation

Potato gehört in die Python-Umgebung, die die Shell von Claude Code verwendet. Die Hilfsskripte des Skills importieren die Registries von Potato und rufen den Befehl potato auf, und der erste Schritt des Skills prüft, ob sich Potato importieren lässt. Das Browser-Extra und Chromium erlauben es potato preview --screenshot und dem Walkthrough-Skript des Skills, die Aufgabe in einem Headless-Browser zu öffnen.

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

Das Plugin installieren

Fügen Sie in einer Claude-Code-Sitzung zuerst das Marketplace hinzu und installieren Sie dann das Plugin.

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

Der Installationsbefehl öffnet die Details des Plugins im /plugin-Panel und fragt nach einem Geltungsbereich.

BereichWer den Skill erhältWo Claude Code das Plugin einträgt
BenutzerSie, in jedem Projekt auf diesem Rechner~/.claude/settings.json
Projektalle, die im Repository arbeiten.claude/settings.json, die Sie einchecken
LokalSie, nur in diesem Repository.claude/settings.local.json

Der Benutzerbereich passt zu Forschenden, die Studien in mehreren Projektordnern aufbauen. Der Projektbereich passt zu einem Labor, dessen Studien ein Repository teilen. Das Einchecken von .claude/settings.json aktiviert das Plugin für Mitarbeitende, lädt es aber nicht auf deren Rechner herunter. Jede mitarbeitende Person führt die Installation einmal aus.

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

Ein Setup-Skript kann dieselben zwei Schritte aus Ihrer Shell ausführen, ohne eine Sitzung zu öffnen.

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

Ein aus der Shell installiertes Plugin wird beim nächsten Start von Claude Code geladen, oder nach /reload-plugins in einer bereits geöffneten Sitzung. Das Terminal, die lokalen Sitzungen der Desktop-App und die VS-Code-Erweiterung auf einem Rechner lesen dieselben Einstellungsdateien. Eine Installation im Benutzerbereich, die in einem der drei vorgenommen wird, erreicht die beiden anderen.

Die Installation prüfen

claude plugin list in Ihrer Shell gibt das Plugin mit Version, Bereich und Status aus.

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

claude plugin details potato-skill listet einen Skill und keine Agenten, Hooks oder MCP-Server auf. Derselbe Befehl schätzt die Kontextkosten des Skills auf etwa 220 Tokens in jeder Sitzung, für den Namen und die Beschreibung des Skills, und auf etwa 10.900 Tokens bei jedem Laden des Skills.

Eine Studie starten

Beschreiben Sie die Studie in normaler Sprache. Claude lädt den Skill ohne Befehl, wenn eine Anfrage zur Beschreibung des Skills passt, etwa die Bitte, eine Annotationsaufgabe aufzubauen, eine Potato-config.yaml zu bearbeiten oder eine laufende Studie zu prüfen.

Ich möchte 200 Tweets von jeweils drei Annotatoren auf einer 5-Punkte-Skala nach Stimmung annotieren lassen, mit einer Einwilligungsseite und zwei Aufmerksamkeitstests. Bau das auf und starte es.

Skills eines Plugins tragen den Namen des Plugins. Wer vor der Anfrage /potato-skill:potato-skill eingibt, lädt den Skill direkt. Die Eingabe von / zeigt den Namen im Befehlsmenü, und /skills listet jeden Skill auf, den Claude Code geladen hat.

Die Befehle freigeben, die der Skill ausführt

Der Skill bittet Claude, die Konfiguration zu validieren, einen Potato-Server zu starten, die Aufgabe in einem Headless-Browser zu öffnen und die Hilfsskripte des Skills auszuführen. Jeder dieser Schritte ist ein Shell-Befehl. Im Standardmodus Manual fragt Claude Code vor jedem Shell-Befehl nach, und die Antwort „Yes, and don't ask again“ speichert eine Regel für diesen Befehl in diesem Repository.

Der Aufbau einer Studie führt potato validate und potato preview viele Male aus. Allow-Regeln in .claude/settings.json geben diese beiden Befehle im Voraus frei und überlassen alles andere einer Nachfrage.

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

/permissions zeigt jede Regel und die Einstellungsdatei, aus der sie stammt. potato-skill deklariert keine allowed-tools. Jeder Befehl, den der Skill anfordert, läuft über Ihre Berechtigungseinstellungen. Die Dokumentation zu Berechtigungen von Claude Code beschreibt die Regelsyntax und die übrigen Berechtigungsmodi.

Ohne das Plugin-System installieren

Die skills-CLI legt dieselben Dateien in .claude/skills/potato-skill/ in Ihrem Projekt ab, wo Claude Code Projekt-Skills liest.

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

Ein Projekt-Skill hat keinen Plugin-Präfix im Namen, sodass /potato-skill den Skill lädt. Das Einchecken von .claude/skills/ gibt Mitarbeitenden den Skill ohne Installationsschritt. Cursor, GitHub Copilot in VS Code und OpenCode lesen ebenfalls .claude/skills/. Die CLI benötigt Node.js 22.20 oder neuer. Cloud-Sitzungen von Claude Code laden keine Plugins, die auf Ihrem eigenen Rechner installiert sind. Der Browser unter claude.ai/code führt Cloud-Sitzungen aus.

Das Plugin aktualisieren und entfernen

Claude Code aktualisiert ein Plugin nur dann automatisch, wenn beim Marketplace des Plugins die automatische Aktualisierung eingeschaltet ist, und für ein von Hand hinzugefügtes Marketplace wie davidjurgens/potato-skill ist sie zunächst ausgeschaltet. Aktualisieren Sie das Plugin aus Ihrer Shell.

bash
claude plugin update potato-skill@potato

Für automatische Updates führen Sie /plugin aus, öffnen den Tab Marketplaces, wählen potato und wählen Enable auto-update. Eine laufende Sitzung behält die Version, die sie geladen hat, und die nächste Sitzung lädt die neue.

claude plugin uninstall potato-skill@potato entfernt das Plugin. /plugin marketplace remove potato entfernt das Marketplace und jedes daraus installierte Plugin. Die Plugin-Dokumentation von Claude Code behandelt das /plugin-Panel vollständig.