Agent Skills: O Google Empacotou 14 Anos de Engenharia em Skills para IA
Vou te contar uma verdade que aprendi mentorando mais de 300 software houses: o problema com IA não é a IA. É que a gente entrega uma ferramenta de Staff Engineer para um agente que se comporta como estagiário apressado.
O agente quer terminar rápido. Pula o spec. Ignora o teste. Esquece o security review. E o dev aprova porque “parece que funciona”. Até explodir em produção.
Addy Osmani, o cara que liderou o Chrome Developer Experience no Google por quase 14 anos, resolveu esse problema da forma mais elegante que eu já vi: empacotou os processos que engenheiros seniores do Google realmente seguem em 20 skills reutilizáveis que qualquer AI coding agent pode usar. E abriu tudo como open-source.
O que é o Agent Skills
Agent Skills é uma coleção de 20 skills de engenharia production-grade para AI coding agents. São workflows estruturados — não documentação de referência — que forçam o agente a seguir processos reais de engenharia em cada fase do desenvolvimento.
- 12.300+ stars no GitHub
- 1.500+ forks
- MIT License — use como quiser
- v0.5.0 lançada em 10 de abril de 2026
- Compatível com: Claude Code, Cursor, Gemini CLI, Windsurf, OpenCode, GitHub Copilot, Kiro IDE
O projeto está no Trendshift como trending e viralizou no X/Twitter e LinkedIn na primeira semana de abril.
Quem é Addy Osmani (e por que isso importa)
Se você é dev, provavelmente já usou algo que Addy Osmani criou ou influenciou. Ele é o Engineering Manager que liderou o Chrome DevTools, Lighthouse e Core Web Vitals no Google. Ficou quase 14 anos no Google Chrome. Escreveu “Learning JavaScript Design Patterns” pela O’Reilly. Gerenciou o programa que financiou projetos como Webpack, Rollup, Vite, Vue.js, Nuxt, Svelte e Astro.
Formado em Sheffield Hallam, mestrado em Warwick, pós-graduação em Design for Security em Oxford. Atualmente transita entre Google DeepMind, engineering e DevRel.
Quando Addy Osmani empacota o que funcionou dentro do Google em um projeto open-source, vale prestar atenção.
O problema que resolve: IA rápida vs. IA correta
Osmani cunhou uma distinção que eu acho brilhante: “vibe coding” vs. “agentic engineering”.
Vibe coding é o que a maioria dos devs faz hoje com IA: pede pro agente codar, aceita o resultado sem revisar, e torce para que funcione. Nas palavras dele: “This isn’t engineering, it’s hoping.”
Agentic engineering é o oposto: a IA implementa, mas sob supervisão arquitetural rigorosa. Spec antes do código. Testes como prova. Review como quality gate. Deploy com staged rollout.
E o insight que mais me marcou:
“AI-assisted development actually rewards good engineering practices MORE than traditional coding does.”
Ou seja: quanto melhores seus specs, mais preciso o output da IA. Quanto mais completos seus testes, mais confiança para delegar. A IA não substitui processo — ela amplifica processo.
Na minha experiência com 300+ SHs, as que estão colhendo resultado com IA são justamente as que já tinham processo de engenharia maduro. As que não tinham estão automatizando a bagunça.
Como funciona: 6 fases, 20 skills, 7 comandos
Agent Skills organiza o trabalho em 6 fases que cobrem o ciclo completo de desenvolvimento:
1. DEFINE — Defina antes de codar
/spec— Cria um PRD completo antes de escrever uma linha- idea-refine — Pensamento divergente/convergente para explorar conceitos
- spec-driven-development — Especificação com objetivos, estrutura, estilo, limites de teste
2. PLAN — Decomponha em tarefas atômicas
/plan— Quebra o spec em tasks verificáveis- planning-and-task-breakdown — Cada task com acceptance criteria
3. BUILD — Implemente incrementalmente
/build— Vertical slices com feature flags- 6 skills incluindo test-driven-development (pirâmide 80% unit / 15% integration / 5% e2e), context-engineering, frontend-ui-engineering (WCAG 2.1 AA), api-and-interface-design (Hyrum’s Law)
4. VERIFY — Prove que funciona
/test— Inspeção runtime via Chrome DevTools- debugging-and-error-recovery — Triage em 5 passos: reproduzir, localizar, reduzir, corrigir, proteger
5. REVIEW — Quality gates
/review+/code-simplify— Review em 5 eixos com changes de ~100 linhas- security-and-hardening (OWASP Top 10), performance-optimization (Core Web Vitals), code-simplification (Chesterton’s Fence)
6. SHIP — Deploy com segurança
/ship— Staged rollouts com monitoring- ci-cd-and-automation, documentation-and-adrs (Architecture Decision Records), shipping-and-launch
Além disso, inclui 3 personas especializadas que o agente pode assumir:
- code-reviewer — perspectiva de Senior Staff Engineer
- test-engineer — foco de QA Specialist
- security-auditor — análise de Security Engineer
O que torna isso diferente: Anti-Racionalização
Essa é a parte genial e que eu nunca vi em outro skill system.
Cada skill inclui uma tabela de anti-racionalização: uma lista de desculpas comuns que AI agents usam para pular etapas, com contra-argumentos documentados.
Exemplo: quando o agente tenta pular testes dizendo “é uma mudança simples”, a tabela rebate com o contra-argumento específico de por que isso é perigoso. Quando tenta pular o spec dizendo “já sei o que precisa ser feito”, tem o rebate pronto.
Isso é engenharia de prompts no nível mais sofisticado que existe. Não é “escreva testes” — é “aqui estão as 8 desculpas que você vai inventar para não escrever testes, e por que cada uma está errada”.
Os princípios do Google por trás
Agent Skills incorpora conceitos de engenharia que vêm da cultura do Google:
- Hyrum’s Law — Toda API observável será dependida por alguém. Projete para isso.
- Beyoncé Rule — “If you liked it, you should have put a test on it.” Se não tem teste, não está protegido.
- Test Pyramid — 80% unitários, 15% integração, 5% e2e. Nessa proporção.
- Chesterton’s Fence — Antes de remover código, entenda por que ele existe.
- Change sizing ~100 linhas — Reviews de 100 linhas são eficazes. De 1.000, são teatro.
- Shift Left — Capture problemas no início, não na deploy.
São princípios que eu prego há anos para as SHs que mentoro. Ver eles codificados em skills de IA é poderoso.
Como usar na sua software house
A instalação é simples. No Claude Code:
/plugin marketplace add addyosmani/agent-skills
Ou clone local:
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills
Funciona também no Cursor, Gemini CLI, Windsurf, OpenCode, GitHub Copilot e Kiro IDE.
5 formas práticas de aplicar na sua SH:
- Padronize o processo de dev com IA — Instale em todas as máquinas da equipe. Todo dev segue o mesmo workflow de qualidade, independente de senioridade.
- Acelere o onboarding — Um junior com agent-skills faz code review no nível de Staff Engineer desde o primeiro dia. O skill guia o agente a verificar os 5 eixos de qualidade.
- Automatize quality gates — Security (OWASP Top 10), performance (Core Web Vitals) e acessibilidade (WCAG 2.1 AA) checados em cada PR automaticamente.
- Gere documentação como subproduto — ADRs (Architecture Decision Records) são criados no fluxo natural. Não é tarefa extra — é output do processo.
- Reduza retrabalho —
/specantes de/buildelimina o “fiz a feature errada”. Nas SHs que mentoro, spec-first reduz retrabalho em 40-60%.
O que eu penso
De todos os projetos de skills para IA que já analisei — e já foram dezenas aqui no blog — agent-skills é o mais maduro e opinativo.
Não é um conjunto de dicas genéricas. É um sistema completo que codifica 14 anos de cultura de engenharia do Google em workflows que uma IA consegue seguir. E o fato de vir do Addy Osmani — alguém que liderou ferramentas usadas por milhões de devs — dá uma credibilidade que poucos projetos open-source têm.
O conceito de anti-racionalização, sozinho, já vale a pena. Eu mesmo uso uma versão simplificada disso nos treinamentos da SH Exponencial: antecipar as desculpas que os times vão dar para não seguir o processo.
Se eu tivesse que recomendar UM skill para instalar hoje em toda a sua equipe de dev, seria esse.
Sou Thulio, mentoro 300+ SHs desde 2016.
