O que é Agent Skills (Addy Osmani)?
Agent Skills é a coleção de skills em Markdown de Addy Osmani que transforma hábitos de engenheiro sênior em etapas que um agente precisa seguir. Cada skill tem um processo, pontos de verificação, uma tabela de desculpas comuns com contra-argumentos, sinais de alerta e as evidências exigidas antes que o agente possa dar o trabalho por concluído. Muitas regras vêm da cultura de engenharia do Google, como a Lei de Hyrum e a Cerca de Chesterton.
O pacote tem 25 skills (24 skills de ciclo de vida mais um roteador using-agent-skills) agrupadas por etapa (definir, planejar, construir, verificar, revisar, entregar), 9 comandos de barra (/spec, /plan, /build, /test, /constraints, /review, /webperf, /code-simplify e /ship), 4 personas revisoras e 7 checklists compartilhados. Ele se instala como plugin do Claude Code ou do Codex, no Gemini CLI e no Antigravity, ou em mais de 70 agentes pela CLI skills. A versão 0.6.13 saiu em 13 de outubro de 2026.
Agent Skills (Addy Osmani) vale a pena?
O Agent Skills é o pacote para um agente cujo problema é disciplina, não conhecimento: aquele que escreve código antes de haver uma especificação, declara vitória sem rodar os testes e entrega um diff de 600 linhas. Toda skill termina em requisitos de evidência e traz uma tabela das desculpas que os agentes usam para pular etapas, cada uma com um contra-argumento. Com cerca de 109,800 estrelas no GitHub, está entre os pacotes de skills mais estrelados, embora o Superpowers, de Jesse Vincent, com cerca de 304,000, seja maior.
Seu terreno próprio é o trabalho web. browser-testing-with-devtools usa o Chrome DevTools MCP para dados de DOM, console, rede e desempenho, /webperf roda uma auditoria de Core Web Vitals por meio de uma persona dedicada, e a skill de front-end fixa o WCAG 2.1 AA como patamar; revisores da Productize viram nisso a única área que os rivais em alta deixaram de lado. /build auto pede aprovação do plano uma vez e depois implementa cada tarefa com testes e um commit próprio, parando em caso de falha. O roteamento de skills é testado em CI contra 25 arquivos de casos de avaliação.
As arestas estão documentadas, o que conta a favor. No Claude Code, o /review embutido prevalece, então você digita /agent-skills:review. Uma instalação npx de uma única skill deixa de fora os checklists compartilhados de references/ aos quais as skills se referem (issue #361). O marketplace do Claude Code clona via SSH e falha sem uma chave do GitHub, a menos que você forneça a URL HTTPS. Os hooks são opcionais e documentados em arquivos próprios: um roteador de início de sessão que o plugin deixa desconectado de propósito, e um cache de WebFetch que revalida com o servidor de origem a cada reutilização.
A abrangência tem um custo de contexto. Osmani recomenda começar pelas quatro ou cinco skills mais próximas dos seus problemas, e rodar o pacote ao lado do Superpowers entrega ao agente dois manuais concorrentes para planejamento, TDD e revisão. As skills de Matt Pocock e o Spec Kit do GitHub cuidam cada um de uma fatia do fluxo; este pacote tenta cuidar de tudo, o que é o motivo para adotá-lo e também o motivo para adotar só uma parte.
Onde ele se destaca
Uma líder de front-end em uma equipe de e-commerce de 15 pessoas que usa o Claude Code
Impedir que páginas escritas pelo agente piorem Core Web Vitals e acessibilidade
Instalar o plugin e exigir /test com browser-testing-with-devtools e uma auditoria /webperf antes do merge; ambos leem dados reais de console, rede e desempenho pelo Chrome DevTools MCP. O pacote é gratuito; o custo são sessões de agente mais longas no plano Claude existente.
Um desenvolvedor solo começando um app SaaS do zero
Ir da ideia a uma primeira versão revisada sem pular a especificação
Rodar /spec para um PRD, /plan para dividi-lo em tarefas e depois /build auto, que pede aprovação do plano uma vez e implementa cada tarefa com testes e um commit separado, parando em caso de falha. O guia de adoção recomenda o ciclo completo para projetos novos e uma adoção gradual para os já estabelecidos.
Um gerente de engenharia levando agentes a 40 desenvolvedores no Codex e no Cursor
Dar a todos os agentes os mesmos padrões de revisão e segurança
Instalar o núcleo compartilhado skills/ em cada ferramenta (plugin do Codex, .cursor/skills) e usar /constraints para escrever uma vez o CONSTRAINTS.md com os limites da equipe. Licença MIT e sem taxa por usuário; reserve tempo para enxugar o pacote, já que as descrições das 25 skills disputam o contexto.
Antes de decidir
- Configuração
- `npx skills add addyosmani/agent-skills` instala as 25 skills na maioria dos agentes. No Claude Code, `/plugin marketplace add addyosmani/agent-skills` e depois `/plugin install agent-skills@addy-agent-skills`, usando a URL HTTPS se não houver chave SSH. O Codex precisa da CLI v0.122+.
- Integrações
- Claude Code, Codex, Gemini CLI, Antigravity, Copilot CLI, Cursor, Windsurf, OpenCode, Kiro e Command Code; Chrome DevTools MCP para testes no navegador. Os comandos de barra do ciclo de vida só existem onde o host os suporta; no Copilot você invoca as skills pelo nome.
- Dados e privacidade
- Markdown simples mais hooks em shell script que rodam dentro do seu agente; o pacote em si não envia nada para lugar nenhum. O hook opcional sdd-cache guarda em disco a documentação baixada e a revalida com o servidor antes de reutilizá-la. Licença MIT.
- Custo em escala
- Gratuito. O custo são tokens: execuções do ciclo completo com especificações, testes e revisões são sessões mais longas que as de um agente sem orientação, e instalar todas as skills carrega mais descrições no contexto. O projeto não publica números de tokens.
- Limites
- Nomes de comandos podem conflitar com comandos embutidos do host; instalações de uma única skill perdem references/; algumas versões do Antigravity escondem os comandos wrapper; sobrepõe-se ao Superpowers em planejamento, TDD e revisão.
O que é bom
- Toda skill termina em requisitos de evidência
- Testes no navegador com Chrome DevTools e auditorias /webperf
- Instala no Claude Code, Codex, Gemini e mais de 70 agentes
- Roteamento de skills testado em CI com 25 casos de avaliação
O que não é
- /review entra em conflito com o comando embutido do Claude Code
- Instalações de uma única skill perdem os checklists compartilhados
- A instalação pelo marketplace falha sem chave SSH do GitHub
- Conflita com o Superpowers se os dois estiverem instalados
Ideal para
Desenvolvedores web que querem um único pacote estruturado de skills da especificação ao lançamento.
Alternativas ao Agent Skills (Addy Osmani)
Agent Skills (Addy Osmani): perguntas frequentes
- Agent Skills (Addy Osmani) vale a pena?
- O pacote de Addy Osmani transforma hábitos de engenheiro sênior em barreiras que um agente não consegue contornar no papo, e é o raro conjunto de skills que leva o navegador a sério. Damos nota 4.3 de 5.
- Quanto custa Agent Skills (Addy Osmani)?
- Gratuito e de código aberto (MIT). Você paga pelo uso de modelo do seu agente.
- Quais são as desvantagens de Agent Skills (Addy Osmani)?
- /review entra em conflito com o comando embutido do Claude Code; instalações de uma única skill perdem os checklists compartilhados; a instalação pelo marketplace falha sem chave SSH do GitHub; conflita com o Superpowers se os dois estiverem instalados.
- Para quem Agent Skills (Addy Osmani) é indicado?
- Desenvolvedores web que querem um único pacote estruturado de skills da especificação ao lançamento.
- Quanto custa Agent Skills (Addy Osmani) para uma equipe ou em produção?
- Gratuito. O custo são tokens: execuções do ciclo completo com especificações, testes e revisões são sessões mais longas que as de um agente sem orientação, e instalar todas as skills carrega mais descrições no contexto. O projeto não publica números de tokens.
- Agent Skills (Addy Osmani) é seguro para dados da empresa?
- Markdown simples mais hooks em shell script que rodam dentro do seu agente; o pacote em si não envia nada para lugar nenhum. O hook opcional sdd-cache guarda em disco a documentação baixada e a revalida com o servidor antes de reutilizá-la. Licença MIT.
- Quais são as melhores alternativas ao Agent Skills (Addy Osmani)?
- As alternativas mais próximas que analisamos são Superpowers, Matt Pocock's Skills e Spec Kit.
Respostas verificadas em 23 de out. de 2026.