Instalar potato-skill en tu agente de programación
Instala potato-skill en Claude Code, Codex, Cursor u otro agente de programación, con el comando de instalación y la carpeta de skills de cada agente.
potato-skill es una Agent Skill, una carpeta de instrucciones y scripts auxiliares que puede cargar cualquier agente de programación compatible con el formato. Claude Code instala potato-skill como plugin, y todos los demás agentes obtienen la carpeta con npx skills add davidjurgens/potato-skill, con el nombre del agente después de --agent. Claude Code, Codex y Cursor tienen cada uno una página de configuración propia. Inicio rápido con un agente de programación explica qué hace la skill con un estudio.
Comandos de instalación por agente
| Agente | Instalación | Carpeta que lee el agente | Página de configuración |
|---|---|---|---|
| Claude Code | /plugin marketplace add davidjurgens/potato-skill, y después /plugin install potato-skill@potato | La caché de plugins de 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 en VS Code | npx skills add davidjurgens/potato-skill --agent github-copilot | .agents/skills/ | más abajo |
| Gemini CLI | npx skills add davidjurgens/potato-skill --agent gemini-cli | .agents/skills/ | más abajo |
| OpenCode | npx skills add davidjurgens/potato-skill --agent opencode | .agents/skills/ | más abajo |
potato-skill se escribió para Claude Code, y el SKILL.md de la skill nombra también las carpetas de instalación de Codex y Cursor. GitHub Copilot, Gemini CLI y OpenCode cargan los mismos archivos. Abre en tu navegador la primera tarea que construya un agente y etiqueta tú mismo unos cuantos ítems antes de invitar a los anotadores.
Antes de instalar
Potato se instala en el entorno de Python que usa el shell del agente. 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.
pip install 'potato-annotation[preview]'
playwright install chromiumLa CLI skills se ejecuta con npx. La versión 1.7.6 de la CLI requiere Node.js 22.20 o posterior.
Qué escribe la CLI skills
npx skills add copia SKILL.md, los 30 archivos de referencia y los nueve scripts auxiliares en .agents/skills/potato-skill/, y registra el origen en skills-lock.json en la raíz del proyecto. Añade -g para instalar en ~/.agents/skills/potato-skill/ para todos los proyectos de la máquina. Codex, Cursor, GitHub Copilot en VS Code, Gemini CLI y OpenCode leen todos .agents/skills/. Un solo comando puede nombrar varios de esos agentes, y los agentes comparten entonces una única copia.
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencodeLa tabla de agentes de la CLI da el nombre de --agent y la carpeta de los demás agentes que la CLI admite. Todos los agentes de esta página también cargan la skill sin ningún comando cuando una petición encaja con la descripción de la skill, por ejemplo una petición de construir una tarea de anotación.
GitHub Copilot en VS Code
VS Code lee .agents/skills/ y .claude/skills/ en las sesiones locales, junto a .github/skills/, la carpeta propia de Copilot. Las skills funcionan tanto en el chat como en el modo agente. Escribir /potato-skill en el chat inicia la skill.
Gemini CLI
Gemini CLI lee .agents/skills/ en el espacio de trabajo y ~/.agents/skills/ para el usuario. /skills list muestra las skills que Gemini encontró. Gemini inicia una skill que coincide sin ningún comando, y te pide confirmar antes de cargar la skill en la conversación.
OpenCode
OpenCode lee .agents/skills/ en todas las carpetas desde la actual hasta el worktree de git, y ~/.agents/skills/ para una instalación global. El agente carga una skill que coincide mediante la herramienta skill de OpenCode.
Sin la CLI skills
El repositorio de potato-skill tiene un AGENTS.md en la raíz, un resumen breve de las reglas de la skill que Codex y Cursor leen por su nombre de archivo. Copiar el archivo en la raíz de tu proyecto da las reglas a un agente sin ningún paso de instalación. El archivo remite a archivos de referencia y scripts que solo una instalación completa deja en el disco. El Inicio rápido con un agente de programación compara la instalación completa con la copia de AGENTS.md. Los archivos de referencia también están publicados en davidjurgens.github.io/potato-skill. Un agente que pueda leer páginas web puede usar la copia publicada, y tú puedes leer los archivos allí antes de instalar.
Actualizar y eliminar la skill
La CLI skills actualiza y elimina la skill por su nombre. Añade -g a cualquiera de los dos comandos para una instalación global.
npx skills update potato-skill
npx skills remove potato-skillupdate compara la copia instalada con el repositorio de GitHub y reemplaza la copia cuando el repositorio ha cambiado. remove elimina .agents/skills/potato-skill/ y la entrada de la skill en skills-lock.json. La página de Claude Code da los comandos para actualizar y eliminar el plugin.