Você pede uma coisa ao agente de código e ele sai programando antes de entender o que você quis dizer. Sem plano, sem teste e sem revisão, o resultado até roda, mas costuma ser diferente do que você tinha na cabeça.
O agent-skills, do Addy Osmani, é um pacote grátis e de código aberto de skills que impõe ao agente o caminho de um engenheiro sênior: especificar, planejar, construir em fatias, testar, revisar e publicar. O pacote reúne 9 comandos que seguem o ciclo de vida de um projeto.
Ele instala no Claude Code com dois comandos e funciona também no Cursor, no Codex e em mais de 70 agentes. Este guia traz a instalação, o que cada comando faz, o /build auto e os cuidados que o vídeo não teve tempo de mostrar.
Instalação no Claude Code
No Claude Code, são dois comandos de plugin. Rode um de cada vez:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
Se o primeiro comando der erro de SSH, use o endereço completo do repositório no lugar do atalho:
/plugin marketplace add https://github.com/addyosmani/agent-skills.git
Se o /plugin install ainda falhar com "Permission denied (publickey)" no Windows ou no Mac, o README manda configurar o Git uma vez para trocar o endereço SSH do GitHub por HTTPS:
git config --global url."https://github.com/".insteadOf git@github.com:
Depois de instalar, os comandos aparecem com o prefixo do pacote.
Os nove comandos e quando usar cada um
Eles seguem a ordem de um projeto:
| Comando | O que faz |
|---|---|
/spec | Escreve a especificação do que vai ser feito, antes de qualquer código |
/plan | Quebra a especificação em tarefas pequenas |
/build | Implementa uma fatia por vez |
/test | Prova que funciona |
/constraints | Define limites e restrições do trabalho |
/review | Revisa tudo antes de juntar o código |
/webperf | Olha o desempenho de páginas web |
/code-simplify | Simplifica o código depois que funciona |
/ship | Leva para produção |
Uma ordem simples para o primeiro projeto: /spec para dizer o que você quer, /plan para ver as tarefas, /build para construir, /test para provar, /review antes de juntar e /ship no fim. Os outros três entram quando fazem sentido: /constraints no começo, /webperf em projeto web e /code-simplify depois que tudo passa nos testes.
Como usar o /build auto
Normalmente o /build implementa uma fatia por vez e espera você. O /build auto gera o plano e implementa todas as tarefas numa passada só, depois de você aprovar o plano uma vez.
Mesmo no modo automático, cada tarefa continua guiada por teste e ganha um commit só dela. Se aparecer uma falha ou um passo arriscado, ele para e espera você. A aprovação do plano é o ponto em que você decide: leia o plano com atenção antes de liberar.
Ele não dispensa revisão. Depois de rodar, passe pelo /review.
Outros agentes: Cursor, Codex e mais
O pacote instala em mais de 70 agentes. Para os que não são o Claude Code, o caminho é o npx skills add:
npx skills add addyosmani/agent-skills
Com --list no fim, você vê o que tem antes de instalar. Para instalar só uma skill, use --skill <nome>. Cada agente tem instruções próprias no README: https://github.com/addyosmani/agent-skills.
Aviso: o /review no Claude Code
O Claude Code já tem um comando /review próprio. Por isso, o /review do pacote não roda com o nome curto: no Claude Code, use /agent-skills:review.
Limites
- É um roteiro de trabalho, não uma garantia: o agente pode continuar errando, mas erra num processo com plano, teste e revisão.
- O
/build autonão elimina a sua decisão: você aprova o plano uma vez, e ele para em falha ou passo arriscado.
Fontes
- Repositório e README do agent-skills: https://github.com/addyosmani/agent-skills (acessado em 12/11/2026)
- Site oficial: https://skills.addy.ie (acessado em 12/11/2026)