#11 no GitHub · Programar com método
Como usar as Agent Skills do Addy Osmani no Claude Code
Um pacote com 25 habilidades e 9 comandos que levam o agente por etapas de um projeto: definir, planejar, construir, testar, revisar e publicar. Cada comando ativa as habilidades certas daquela etapa.
- Para quem
- Quem constrói software com agente de código e quer que ele siga um processo com portões de qualidade, em vez de pular direto para o código.
- Estrelas (02/11/2026)
- 112.822, #11 no ranking
- Licença
- MIT
- Repositório
- addyosmani/agent-skills
Passo a passo
Antes de começar: Claude Code instalado.
Abra o Claude Code
Os dois comandos de instalação são digitados dentro de uma sessão do Claude Code. O README marca esse como o caminho recomendado.
Registre o catálogo do pacote
Este comando diz ao Claude Code onde encontrar o pacote. Ainda não instala nada.
Comando/plugin marketplace add addyosmani/agent-skills
Instale o plugin
Agora sim a instalação. Depois dela, os comandos do pacote ficam disponíveis na sessão.
Comando/plugin install agent-skills@addy-agent-skills
Comece definindo o que construir
O primeiro comando do ciclo é o /spec. O princípio dele, segundo o README, é escrever a especificação antes do código.
Comando/spec
Siga a ordem dos comandos
Depois do /spec, o ciclo continua com /plan, /build, /test, /review e /ship. Cada um tem um princípio guia na tabela do README.
Primeiro teste
Numa sessão do Claude com a skill instalada, cole:
/spec
O README diz que o comando serve para definir o que construir, com o princípio "spec before code" (especificação antes do código).
Cuidados
- O marketplace baixa os arquivos pelo GitHub via SSH. Sem chave SSH cadastrada, a instalação pode falhar.
- O /build auto gera o plano e executa todas as tarefas de uma vez depois de uma única aprovação sua. Para em falhas e em passos arriscados, mas é bem mais autônomo que o /build comum.
- O pacote traz comandos de ciclo de vida (hooks) além dos comandos de barra, segundo a tabela de estrutura do README.
- O /review tem o mesmo nome de um comando que já vem no Claude Code. Para chamar o do pacote, use a forma com prefixo: /agent-skills:review.
Como desfazer
O README não explica como remover.
O que o README não confirma
Esta página foi montada lendo o README. Estes pontos não estão escritos lá:
- O README não diz o que o /spec produz na prática (arquivo, formato, onde salva). A habilidade spec-driven-development é descrita como PRD com objetivos, comandos, estrutura, estilo de código, testes e limites, mas a ligação direta com o comando não está escrita.
- O README não diz se é preciso abrir uma sessão nova depois de instalar.
- O README não diz que o Git precisa estar instalado, embora o marketplace clone repositórios.
- O README não traz instrução de desinstalação.
Dúvidas
Deu erro de SSH (Permission denied publickey). O que faço?
O README manda registrar o catálogo pela URL HTTPS: /plugin marketplace add https://github.com/addyosmani/agent-skills.git e depois repetir /plugin install agent-skills@addy-agent-skills. Se ainda falhar no Windows ou no macOS, ele indica configurar o Git uma vez para trocar as URLs SSH do GitHub por HTTPS.
Preciso usar todos os comandos?
Não. As habilidades também ativam sozinhas conforme o que você faz. Por exemplo, desenhar uma API aciona a api-and-interface-design.
Dá para instalar só uma habilidade?
Dá, com o comando npx skills add addyosmani/agent-skills --skill e o nome da habilidade. O README avisa que, nesse modo, as checklists compartilhadas da pasta references não vêm junto, e a habilidade continua funcionando.
A DNACX já usou as Agent Skills do Addy Osmani?
Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.
Próxima da lista
Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de addyosmani/agent-skills, lido em . A DNACX não rodou cada passo desta página. A skill é de terceiros e a DNACX não a criou.