Pular para o conteúdo

Configure o potato-skill no Claude Code

Instale o potato-skill como plugin do Claude Code, escolha o escopo que decide quem recebe o plugin e aprove os comandos que a skill executa.

O Claude Code instala o potato-skill como plugin, com /plugin marketplace add davidjurgens/potato-skill seguido de /plugin install potato-skill@potato. O plugin adiciona uma única skill, sem agentes, hooks ou servidores MCP, e o Claude carrega a skill sempre que um pedido trata de construir ou executar um estudo de anotação. O potato-skill foi escrito para o Claude Code, e esse caminho entrega todas as partes da skill como foram projetadas. 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 shell do Claude Code 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

Instalando o plugin

Em uma sessão do Claude Code, adicione o marketplace e depois instale o plugin:

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

O comando de instalação abre os detalhes do plugin no painel /plugin e pede um escopo:

EscopoQuem recebe a skillOnde o Claude Code registra o plugin
Usuáriovocê, em todos os projetos desta máquina~/.claude/settings.json
Projetotodos que trabalham no repositório.claude/settings.json, que você versiona com commit
Localvocê, somente neste repositório.claude/settings.local.json

O escopo Usuário serve para um pesquisador que constrói estudos em várias pastas de projeto. O escopo Projeto serve para um laboratório cujos estudos compartilham um só repositório. Fazer o commit de .claude/settings.json ativa o plugin para os colaboradores, mas não baixa o plugin nas máquinas deles. Cada colaborador executa a instalação uma vez:

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

Um script de configuração pode executar os mesmos dois passos a partir do shell, sem abrir uma sessão:

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

Um plugin instalado pelo shell é carregado na próxima vez que o Claude Code iniciar, ou depois de /reload-plugins em uma sessão que já está aberta. O terminal, as sessões locais do aplicativo desktop e a extensão do VS Code em um mesmo computador leem os mesmos arquivos de configurações. Uma instalação com escopo Usuário em qualquer um dos três alcança os outros dois.

Conferindo a instalação

claude plugin list no seu shell mostra o plugin com a versão, o escopo e o status dele:

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

claude plugin details potato-skill lista uma skill e nenhum agente, hook ou servidor MCP. O mesmo comando estima o custo da skill em contexto em cerca de 220 tokens em toda sessão, pelo nome e pela descrição da skill, e em cerca de 10.900 tokens cada vez que a skill é carregada.

Iniciando um estudo

Descreva o estudo em linguagem comum. O Claude carrega a skill sem um 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:

Quero 200 tweets rotulados por sentimento numa escala de 5 pontos, com três anotadores por item, uma página de consentimento e duas verificações de atenção. Construa e inicie.

As skills de plugin recebem o nome do plugin. Digitar /potato-skill:potato-skill antes do pedido carrega a skill diretamente. Digitar / mostra o nome no menu de comandos, e /skills lista todas as skills que o Claude Code carregou.

Aprovando os comandos que a skill executa

A skill pede ao Claude que valide a configuração, inicie um servidor do Potato, abra a tarefa em um navegador sem interface e execute os scripts auxiliares da skill. Cada um desses é um comando de shell. No modo Manual padrão, o Claude Code pergunta antes de executar um comando de shell, e responder "Yes, and don't ask again" salva uma regra para esse comando nesse repositório.

Construir um estudo executa potato validate e potato preview muitas vezes. Regras allow em .claude/settings.json aprovam esses dois comandos de antemão e deixam todo o resto para uma pergunta:

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

/permissions mostra todas as regras e o arquivo de configurações de onde cada uma vem. O potato-skill não declara allowed-tools. Todo comando que a skill pede passa pelas suas configurações de permissão. A documentação de permissões do Claude Code descreve a sintaxe das regras e os outros modos de permissão.

Instalando sem o sistema de plugins

A skills CLI coloca os mesmos arquivos em .claude/skills/potato-skill/ no seu projeto, onde o Claude Code lê as skills de projeto:

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

Uma skill de projeto tem o nome sem o prefixo de plugin, então /potato-skill carrega a skill. Fazer o commit de .claude/skills/ dá a skill aos colaboradores sem nenhum passo de instalação. O Cursor, o GitHub Copilot in VS Code e o OpenCode também leem .claude/skills/. A CLI exige o Node.js 22.20 ou posterior. As sessões na nuvem do Claude Code não carregam plugins instalados na sua própria máquina. O navegador em claude.ai/code executa as sessões na nuvem.

Atualizando e removendo o plugin

O Claude Code atualiza um plugin automaticamente só quando o marketplace do plugin está com a atualização automática ativada, e a atualização automática começa desativada em um marketplace adicionado à mão, como davidjurgens/potato-skill. Atualize o plugin pelo shell:

bash
claude plugin update potato-skill@potato

Para atualizar automaticamente, execute /plugin, abra a aba Marketplaces, selecione potato e escolha Enable auto-update. Uma sessão em andamento mantém a versão que carregou, e a próxima sessão carrega a nova.

claude plugin uninstall potato-skill@potato remove o plugin. /plugin marketplace remove potato remove o marketplace e todos os plugins instalados a partir dele. A documentação de plugins do Claude Code cobre o painel /plugin por inteiro.

Leitura complementar