Pular para o conteúdo

Configure o potato-skill no Cursor

Adicione o potato-skill a um projeto do Cursor com um único comando npx, inicie a skill no chat Agent com /potato-skill e aprove os comandos que a skill executa.

O Cursor carrega skills de .agents/skills/ no seu projeto, e npx skills add davidjurgens/potato-skill --agent cursor copia o potato-skill para lá. Digitar /potato-skill no chat Agent anexa a skill a uma mensagem. potato-skill: crie um estudo de anotação com um agente de programação descreve o que a skill faz com um estudo, e Instale o potato-skill no seu agente de programação trata dos outros agentes.

Antes de instalar

O Potato vai no ambiente Python que o terminal do Cursor usa. Os scripts auxiliares da skill importam os registros do Potato e chamam o comando potato, e o primeiro passo da skill confere se o Potato pode ser importado. O extra de navegador e o Chromium permitem que potato preview --screenshot e o script de percurso da skill abram a tarefa em um navegador sem interface:

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

A skills CLI é executada pelo npx e exige o Node.js 22.20 ou posterior.

Instalando a skill

Execute a instalação na pasta do seu projeto:

bash
npx skills add davidjurgens/potato-skill --agent cursor

O comando copia o SKILL.md, os 30 arquivos de referência e os nove scripts auxiliares para .agents/skills/potato-skill/, e registra a origem em skills-lock.json na raiz do projeto. O Cursor carrega skills automaticamente de .agents/skills/ e .cursor/skills/. Fazer o commit de .agents/skills/ dá a mesma skill aos colaboradores que abrem o repositório no Cursor.

Acrescente -g para instalar a skill, em vez disso, para todos os projetos da máquina:

bash
npx skills add davidjurgens/potato-skill --agent cursor -g

Uma instalação global vai para ~/.agents/skills/potato-skill/, uma pasta no nível do usuário que o Cursor também lê. O Cursor lê .claude/skills/ igualmente. Um projeto com o potato-skill em .claude/skills/ não precisa de uma segunda cópia para o Cursor.

Conferindo a instalação

Abra Customize na barra lateral do Cursor e vá até Skills, onde o potato-skill aparece na lista. O potato-skill não tem relação com a skill poteto-mode do plugin pstack para o Cursor, de Lauren Tan.

Iniciando um estudo

Digitar /potato-skill no chat Agent anexa a skill a uma única mensagem:

text
/potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.

O Cursor também carrega a skill sem o comando quando um pedido corresponde à descrição da skill, como o pedido de construir uma tarefa de anotação, editar um config.yaml do Potato ou verificar um estudo em andamento.

Modos de execução e aprovações

O Cursor executa os comandos de terminal do agente sob o modo de execução definido em Settings > Agents > Approvals & Execution. O modo padrão, Auto-review, executa os comandos em um sandbox que bloqueia o acesso à rede por padrão, e o Cursor pede aprovação quando um comando precisa rodar fora do sandbox. As verificações da skill iniciam um servidor do Potato na sua máquina e abrem a tarefa em um navegador sem interface. Leia cada comando que o Cursor mostrar antes de aprová-lo. A página de modos de execução do Cursor documenta a allowlist e as configurações do sandbox.

Atualizando e removendo a skill

A skills CLI atualiza e remove a skill pelo nome. Acrescente -g a qualquer um dos comandos para uma instalação global:

bash
npx skills update potato-skill
npx skills remove potato-skill

update compara a cópia instalada com o repositório do GitHub e substitui a cópia quando o repositório mudou. remove apaga .agents/skills/potato-skill/ e a entrada da skill em skills-lock.json.

Leitura complementar