Instale o potato-skill no seu agente de programação
Instale o potato-skill no Claude Code, no Codex, no Cursor ou em outro agente de programação, com o comando de instalação e a pasta de skills de cada agente.
O potato-skill é uma skill de agente, uma pasta de instruções e scripts auxiliares que qualquer agente de programação compatível com o formato pode carregar. O Claude Code instala o potato-skill como plugin, e todos os outros agentes recebem a pasta de npx skills add davidjurgens/potato-skill, com o nome do agente depois de --agent. O Claude Code, o Codex e o Cursor têm, cada um, uma página de configuração própria. potato-skill: crie um estudo de anotação com um agente de programação descreve o que a skill faz com um estudo.
Comandos de instalação por agente
| Agente | Instalação | Pasta que o agente lê | Página de configuração |
|---|---|---|---|
| Claude Code | /plugin marketplace add davidjurgens/potato-skill, depois /plugin install potato-skill@potato | O cache de plugins do 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 in VS Code | npx skills add davidjurgens/potato-skill --agent github-copilot | .agents/skills/ | abaixo |
| Gemini CLI | npx skills add davidjurgens/potato-skill --agent gemini-cli | .agents/skills/ | abaixo |
| OpenCode | npx skills add davidjurgens/potato-skill --agent opencode | .agents/skills/ | abaixo |
O potato-skill foi escrito para o Claude Code, e o SKILL.md da skill também indica as pastas de instalação do Codex e do Cursor. O GitHub Copilot, o Gemini CLI e o OpenCode carregam os mesmos arquivos. Abra no navegador a primeira tarefa que um agente construir e rotule alguns itens você mesmo antes de convidar anotadores.
Antes de instalar
O Potato vai no ambiente Python que o shell do agente 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:
pip install 'potato-annotation[preview]'
playwright install chromiumA skills CLI é executada pelo npx. A versão 1.7.6 da CLI exige o Node.js 22.20 ou posterior.
O que a skills CLI grava
O npx skills add 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. Acrescente -g para instalar em ~/.agents/skills/potato-skill/, para todos os projetos da máquina. O Codex, o Cursor, o GitHub Copilot in VS Code, o Gemini CLI e o OpenCode leem todos .agents/skills/. Um único comando pode citar vários desses agentes, e os agentes passam a compartilhar uma só cópia:
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencodeA tabela de agentes da CLI traz o nome de --agent e a pasta dos outros agentes que a CLI suporta. Todos os agentes desta página também carregam a skill sem um comando quando um pedido corresponde à descrição da skill, como o pedido de construir uma tarefa de anotação.
GitHub Copilot in VS Code
O VS Code lê .agents/skills/ e .claude/skills/ em sessões locais, ao lado do .github/skills/ do próprio Copilot. As skills funcionam tanto no chat quanto no modo agente. Digitar /potato-skill no chat inicia a skill.
Gemini CLI
O Gemini CLI lê .agents/skills/ no workspace e ~/.agents/skills/ para o usuário. /skills list mostra as skills que o Gemini encontrou. O Gemini inicia uma skill correspondente sem um comando e pede que você confirme antes de carregá-la na conversa.
OpenCode
O OpenCode lê .agents/skills/ em cada pasta, da atual até o worktree do git, e ~/.agents/skills/ para uma instalação global. O agente carrega uma skill correspondente pela ferramenta skill do OpenCode.
Sem a skills CLI
O repositório do potato-skill tem um AGENTS.md na raiz, um resumo curto das regras da skill que o Codex e o Cursor leem pelo nome do arquivo. Copiar o arquivo para a raiz do seu projeto dá ao agente as regras sem nenhum passo de instalação. O arquivo aponta para arquivos de referência e scripts que só uma instalação completa coloca no disco. O potato-skill: crie um estudo de anotação com um agente de programação compara a instalação completa com a cópia do AGENTS.md. Os arquivos de referência também estão publicados em davidjurgens.github.io/potato-skill. Um agente que consegue ler páginas da web pode usar a cópia publicada, e você pode ler os arquivos lá antes de instalar.
Atualizar e remover a skill
A skills CLI atualiza e remove a skill pelo nome. Acrescente -g a qualquer um dos comandos para uma instalação global:
npx skills update potato-skill
npx skills remove potato-skillupdate 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. A página do Claude Code traz os comandos de atualização e remoção do plugin.