potato-skill: Inicio rápido con un agente de programación
Describe a Claude Code los datos que necesitas que etiqueten personas y potato-skill diseña el estudio, lo construye como una tarea de anotación de Potato con su propia interfaz y la pone en marcha.
Hay dos formas de empezar un proyecto de Potato. Puedes escribir la tarea tú mismo, como muestra el Inicio rápido, o describir el estudio a un agente de programación y dejar que potato-skill lo diseñe y lo construya. Esta página trata la segunda. Las dos terminan en el mismo sitio: una tarea de anotación de Potato que puedes ejecutar, cambiar y compartir.
Decisiones de diseño que toma la skill
potato-skill es una skill de agente, un paquete de instrucciones y scripts auxiliares que un agente de programación carga cuando una petición lo necesita. Se ocupa tanto del diseño del estudio como de su construcción, desde el conjunto de etiquetas hasta los datos exportados:
- qué preguntar a los anotadores y con qué escala
- cuántos anotadores necesita cada elemento
- cómo formar a los anotadores y revisar su trabajo
- la interfaz que ven los anotadores
- poner en marcha la tarea y recorrerla como lo haría un anotador
- exportar los resultados en el formato que necesita el siguiente paso
También trabaja con estudios que ya están en marcha. Informa del progreso y del acuerdo, y dice qué cambios son seguros una vez que los anotadores han empezado.
La tarea que construye funciona sobre Potato, así que incluye lo que Potato ya hace: un inicio de sesión por anotador, varios anotadores por elemento, estadísticas de acuerdo, integración con Prolific y MTurk y exportación a los formatos que leen las herramientas posteriores.
Requisitos
Potato tiene que estar instalado donde el agente ejecuta comandos, porque los scripts auxiliares de la skill importan Potato y llaman al comando potato:
pip install potato-annotationTambién necesitas un agente de programación. La skill se escribió para Claude Code; la siguiente sección trata otros agentes.
Instalar la skill
En Claude Code:
/plugin marketplace add davidjurgens/potato-skill
/plugin install potato-skill@potato
Para Codex, Cursor y otros agentes, la CLI skills la instala en tu proyecto:
npx skills add davidjurgens/potato-skill --agent codex cursorCon --agent codex cursor copia la skill en .agents/skills/potato-skill/. Codex y Cursor también pueden leer el archivo AGENTS.md de la raíz del repositorio de potato-skill.
Describir el estudio
Di qué hay que etiquetar, quién lo va a etiquetar y para qué sirven las etiquetas. No necesitas conocer los tipos de anotación de Potato ni su formato de configuración. Una petición puede ser así de corta:
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 comprobaciones de atención. Constrúyelo y ponlo en marcha.
La skill decide la redacción de las preguntas, la escala, cómo se asignan los elementos y cómo se revisa a los anotadores. Después el agente construye la tarea, la pone en marcha y la recorre como lo haría un anotador antes de entregártela. Ábrela en el navegador y etiqueta tú mismo algunos elementos antes de invitar a nadie.
La tarea resultante
Una tarea de Potato: una carpeta de proyecto con la configuración, los datos y las instrucciones de la tarea. Todo lo del Inicio rápido se aplica a ella. La inicias con potato start config.yaml, la editas a mano, añades anotadores y exportas las etiquetas.
Como el resultado es una carpeta de tarea de Potato, otras personas también pueden usarla. Un colega puede ejecutar el mismo estudio con datos nuevos, tú puedes repetirlo el año que viene y puedes publicarlo junto al artículo que lo usó. El showcase es una colección de tareas compartidas así, tomadas de artículos publicados.
Diseños y anotaciones existentes
- Un diseño publicado. La skill puede partir de uno de los 440 diseños de anotación tomados de artículos publicados, con sus conjuntos de etiquetas, la redacción de sus preguntas y sus instrucciones. Puedes explorarlos en el showcase.
- Anotaciones de otra herramienta. Importa anotaciones existentes de Label Studio, CVAT o COCO, así que un proyecto a medias puede continuar en Potato.
- Un estudio en marcha. Informa del progreso de cada anotador y del acuerdo en cada pregunta, y dice qué correcciones son seguras a mitad del estudio y cuáles estropearían los datos ya recogidos.
Pruebas contra los registros de Potato
La CI de la skill comprueba que cada tipo de anotación, clave de configuración y configuración de ejemplo que nombran sus instrucciones existe en Potato. El YAML de ejemplo pasa por el validador de Potato, y el ejemplo completo arranca un servidor real de Potato. Tres de sus referencias se generan a partir de los propios registros de Potato, de modo que los tipos y claves que lee el agente son los que aplica el servidor.
Su material de referencia está publicado en davidjurgens.github.io/potato-skill y se puede leer sin instalar nada. Anthropic recomienda revisar cualquier skill antes de instalarla.
Comparación de las dos formas
| Escribir la tarea tú mismo | Describirla a un agente de programación | |
|---|---|---|
| Empiezas con | una configuración YAML | una descripción en lenguaje corriente |
| Adecuada para | aprender Potato, tareas pequeñas | estudios nuevos, estudios de crowdsourcing con formación y comprobaciones, tipos de anotación que no has usado |
| Terminas con | una tarea de Potato | una tarea de Potato |
Puedes cambiar de forma en cualquier momento. Un agente puede modificar una tarea que escribiste, y tú puedes editar una que construyó el agente.