Ir al contenido

Configurar potato-skill en Claude Code

Instala potato-skill como plugin de Claude Code, elige el ámbito que decide quién recibe el plugin y aprueba los comandos que ejecuta la skill.

Claude Code instala potato-skill como plugin, con /plugin marketplace add davidjurgens/potato-skill seguido de /plugin install potato-skill@potato. El plugin añade una sola skill, sin agentes, hooks ni servidores MCP, y Claude carga la skill siempre que una petición trata de construir o ejecutar un estudio de anotación. potato-skill se escribió para Claude Code, y esta vía ofrece todas las partes de la skill tal como se diseñaron. Inicio rápido con un agente de programación explica qué hace la skill con un estudio, y Instalar potato-skill en tu agente de programación cubre los demás agentes.

Antes de instalar

Potato se instala en el entorno de Python que usa el shell de Claude Code. Los scripts auxiliares de la skill importan los registros de Potato y llaman al comando potato, y el primer paso de la skill comprueba que Potato se importa. El extra de navegador y Chromium permiten que potato preview --screenshot y el script de recorrido de la skill abran la tarea en un navegador sin interfaz.

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

Instalar el plugin

En una sesión de Claude Code, añade el marketplace y después instala el plugin.

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

El comando de instalación abre los detalles del plugin en el panel /plugin y pide un ámbito.

ÁmbitoQuién recibe la skillDónde registra Claude Code el plugin
Usuariotú, en todos los proyectos de esta máquina~/.claude/settings.json
Proyectotodas las personas que trabajan en el repositorio.claude/settings.json, que subes al repositorio
Localtú, solo en este repositorio.claude/settings.local.json

El ámbito de usuario conviene a quien construye estudios en varias carpetas de proyecto. El ámbito de proyecto conviene a un laboratorio cuyos estudios comparten un repositorio. Subir .claude/settings.json al repositorio activa el plugin para los colaboradores, pero no lo descarga en sus máquinas. Cada colaborador ejecuta la instalación una vez.

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

Un script de configuración puede ejecutar los mismos dos pasos desde tu shell, sin abrir una sesión.

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

Un plugin instalado desde el shell se carga la próxima vez que se inicia Claude Code, o tras /reload-plugins en una sesión que ya está abierta. La terminal, las sesiones locales de la aplicación de escritorio y la extensión de VS Code de un mismo equipo leen los mismos archivos de ajustes. Una instalación de ámbito de usuario hecha en cualquiera de las tres llega a las otras dos.

Comprobar la instalación

claude plugin list en tu shell muestra el plugin con su versión, su ámbito y su estado.

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

claude plugin details potato-skill enumera una skill y ningún agente, hook ni servidor MCP. El mismo comando estima el coste de contexto de la skill en unos 220 tokens en cada sesión, por el nombre y la descripción de la skill, y en unos 10 900 tokens cada vez que la skill se carga.

Empezar un estudio

Describe el estudio en lenguaje natural. Claude carga la skill sin ningún comando cuando una petición coincide con la descripción de la skill, por ejemplo una petición de construir una tarea de anotación, editar un config.yaml de Potato o consultar un estudio en marcha.

Quiero que tres anotadores etiqueten cada uno 200 tuits según su sentimiento en una escala de 5 puntos, con una página de consentimiento y dos verificaciones de atención. Constrúyelo y ponlo en marcha.

Las skills de un plugin llevan el nombre del plugin. Escribir /potato-skill:potato-skill antes de la petición carga la skill directamente. Escribir / muestra el nombre en el menú de comandos, y /skills enumera todas las skills que Claude Code ha cargado.

Aprobar los comandos que ejecuta la skill

La skill le pide a Claude que valide la configuración, inicie un servidor de Potato, abra la tarea en un navegador sin interfaz y ejecute los scripts auxiliares de la skill. Cada uno de ellos es un comando de shell. En el modo Manual predeterminado, Claude Code pregunta antes de ejecutar un comando de shell, y responder "Yes, and don't ask again" guarda una regla para ese comando en ese repositorio.

La construcción de un estudio ejecuta potato validate y potato preview muchas veces. Las reglas allow de .claude/settings.json aprueban de antemano esos dos comandos y dejan todo lo demás sujeto a confirmación.

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

/permissions muestra todas las reglas y el archivo de ajustes del que procede cada una. potato-skill no declara allowed-tools. Todo comando que pide la skill pasa por tus ajustes de permisos. La documentación de permisos de Claude Code describe la sintaxis de las reglas y los demás modos de permisos.

Instalar sin el sistema de plugins

La CLI skills coloca los mismos archivos en .claude/skills/potato-skill/ dentro de tu proyecto, donde Claude Code lee las skills de proyecto.

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

Una skill de proyecto se nombra sin prefijo de plugin, de modo que /potato-skill carga la skill. Subir .claude/skills/ al repositorio da la skill a los colaboradores sin ningún paso de instalación. Cursor, GitHub Copilot en VS Code y OpenCode también leen .claude/skills/. La CLI necesita Node.js 22.20 o posterior. Las sesiones en la nube de Claude Code no cargan los plugins instalados en tu propia máquina. El navegador en claude.ai/code ejecuta las sesiones en la nube.

Actualizar y eliminar el plugin

Claude Code actualiza un plugin automáticamente solo cuando el marketplace del plugin tiene activada la actualización automática, y esa actualización viene desactivada en un marketplace añadido a mano, como davidjurgens/potato-skill. Actualiza el plugin desde tu shell.

bash
claude plugin update potato-skill@potato

Para actualizar de forma automática, ejecuta /plugin, abre la pestaña Marketplaces, selecciona potato y elige Enable auto-update. Una sesión en curso conserva la versión que cargó, y la sesión siguiente carga la nueva.

claude plugin uninstall potato-skill@potato elimina el plugin. /plugin marketplace remove potato elimina el marketplace y todos los plugins instalados desde él. La documentación de plugins de Claude Code describe el panel /plugin por completo.

Lecturas adicionales