potato-skill: Início rápido com um agente de programação
Descreva ao Claude Code os dados que precisam ser rotulados por pessoas. O potato-skill projeta o estudo, o constrói como uma tarefa de anotação do Potato com interface própria e a inicia.
Há duas formas de começar um projeto no Potato. Você pode escrever a tarefa por conta própria, como mostra o Início rápido, ou descrever o estudo a um agente de programação e deixar que o potato-skill o projete e construa. Esta página trata da segunda. As duas chegam ao mesmo resultado: uma tarefa de anotação do Potato que você pode executar, alterar e compartilhar.
Decisões de projeto que o potato-skill toma
O potato-skill é uma skill de agente, um pacote de instruções e scripts auxiliares que um agente de programação carrega quando um pedido precisa deles. Ele cuida tanto do projeto do estudo quanto da construção, do conjunto de rótulos até os dados exportados:
- o que perguntar aos anotadores e em que escala
- quantos anotadores cada item precisa
- como treinar os anotadores e verificar o trabalho deles
- a interface que os anotadores veem
- iniciar a tarefa e percorrê-la como um anotador faria
- exportar os resultados no formato de que a próxima etapa precisa
Ele também trabalha com estudos que já estão em andamento. Informa o progresso e a concordância, e diz quais mudanças são seguras depois que os anotadores começaram.
A tarefa que ele constrói roda no Potato, então vem com o que o Potato já faz: login para cada anotador, vários anotadores por item, estatísticas de concordância, integração com Prolific e MTurk e exportação para os formatos que as ferramentas seguintes leem.
Requisitos
O Potato precisa estar instalado onde o agente executa comandos, porque os scripts auxiliares do potato-skill importam o Potato e chamam o comando potato:
pip install potato-annotationVocê também precisa de um agente de programação. O potato-skill foi escrito para o Claude Code; a próxima seção trata de outros agentes.
Instalar o potato-skill
No Claude Code:
/plugin marketplace add davidjurgens/potato-skill
/plugin install potato-skill@potato
Para Codex, Cursor e outros agentes, a CLI skills o instala no seu projeto:
npx skills add davidjurgens/potato-skill --agent codex cursorCom --agent codex cursor, ela copia a skill para .agents/skills/potato-skill/. O Codex e o Cursor também podem ler o arquivo AGENTS.md na raiz do repositório do potato-skill.
Descrever o estudo
Diga o que precisa ser rotulado, quem vai rotular e para que servem os rótulos. Você não precisa conhecer os tipos de anotação do Potato nem o formato de configuração dele. Um pedido pode ser curto assim:
Quero que três anotadores rotulem, cada um, 200 tweets por sentimento numa escala de 5 pontos, com uma página de consentimento e duas verificações de atenção. Construa e inicie.
O potato-skill define o texto das perguntas, a escala, a forma de distribuir os itens e a forma de verificar os anotadores. Depois o agente constrói a tarefa, a inicia e a percorre como um anotador faria antes de entregá-la. Abra-a no navegador e rotule você mesmo alguns itens antes de convidar outras pessoas.
A tarefa resultante
Uma tarefa do Potato: uma pasta de projeto com a configuração, os dados e as instruções da tarefa. Tudo o que está no Início rápido vale para ela. Você a inicia com potato start config.yaml, edita à mão, adiciona anotadores e exporta os rótulos.
Como o resultado é uma pasta de tarefa do Potato, outras pessoas também podem usá-la. Um colega pode rodar o mesmo estudo com dados novos, você pode repeti-lo no ano que vem e publicá-lo junto com o artigo que o usou. A vitrine é uma coleção de tarefas compartilhadas dessa forma, tiradas de artigos publicados.
Designs e anotações existentes
- Um design publicado. O potato-skill pode partir de um dos 440 designs de anotação tirados de artigos publicados, com seus conjuntos de rótulos, o texto das perguntas e as instruções. Você pode explorá-los na vitrine.
- Anotações de outra ferramenta. Ele importa anotações existentes do Label Studio, do CVAT ou do COCO, para que um projeto pela metade possa continuar no Potato.
- Um estudo em andamento. Ele informa o progresso de cada anotador e a concordância em cada pergunta, e diz quais correções são seguras no meio do estudo e quais corromperiam os dados já coletados.
Testes contra os registros do Potato
A CI do potato-skill verifica que cada tipo de anotação, chave de configuração e configuração de exemplo citados nas instruções existe no Potato. O YAML de exemplo passa pelo validador do Potato, e o exemplo completo sobe um servidor Potato de verdade. Três das referências são geradas a partir dos próprios registros do Potato, então os tipos e as chaves que o agente lê são os que o servidor aplica.
O material de referência está publicado em davidjurgens.github.io/potato-skill e pode ser lido sem instalar nada. A Anthropic recomenda revisar qualquer skill antes de instalá-la.
Comparação entre as duas formas
| Escrever a tarefa você mesmo | Descrevê-la a um agente de programação | |
|---|---|---|
| Você começa com | uma configuração YAML | uma descrição em linguagem comum |
| Indicada para | aprender o Potato, tarefas pequenas | estudos novos, estudos de crowdsourcing com treinamento e verificações, tipos de anotação que você ainda não usou |
| Você termina com | uma tarefa do Potato | uma tarefa do Potato |
Você pode trocar de forma a qualquer momento. Um agente pode alterar uma tarefa que você escreveu, e você pode editar uma que o agente construiu.