mattpocock/skills

O que é, em uma frase honesta

É a pasta de instruções pessoais de Matt Pocock, um dos educadores de programação mais conhecidos do mundo (famoso por ensinar TypeScript), publicada para qualquer um usar com agentes de IA como o Claude Code. Cada 'skill' é um manual curto que ensina o agente um procedimento: entrevistar o desenvolvedor antes de escrever código (grill-me), escrever o teste antes da funcionalidade (tdd), diagnosticar bugs com método (diagnosing-bugs), revisar código (code-review) e cuidar da arquitetura todo dia (improve-codebase-architecture). O subtítulo do repositório diz tudo: 'skills para engenheiros de verdade', em oposição ao chamado vibe coding, aquele hábito de aceitar qualquer coisa que a IA cospe.

Não é um software no sentido clássico. É quase todo texto, e isso é proposital: dá para ler, auditar e adaptar tudo.

Para que serve na prática

O time instala como plugin do Claude Code ou via um comando npx que funciona com outros agentes, e passa a invocar as skills por nome. Casos concretos: antes de uma tarefa, o grill-me faz o agente crivar o desenvolvedor de perguntas até os dois entenderem a mesma coisa, o que corta retrabalho na raiz. O tdd obriga o agente a escrever o teste primeiro, criando um alarme automático quando o código quebra.

Um arquivo CONTEXT.md registra o vocabulário do projeto, então ninguém precisa reexplicar o negócio a cada conversa (e gasta menos token). Há ainda skills para transformar ideia em especificação (to-spec), implementar com incrementos pequenos (implement) e passar o bastão entre sessões de trabalho (handoff). O repositório mira quatro dores: desalinhamento, verborragia, código quebrado e arquitetura que apodrece.

Quando faz sentido pra você que lidera

Se o seu time já programa com agentes de IA, o risco hoje não é a IA produzir pouco. É produzir muito e errado: código que ninguém revisou virando passivo técnico, o equivalente a construir andares novos sobre fundação trincada. Este repositório é um jeito barato de instalar disciplina nesse fluxo.

Custo direto zero (licença MIT, arquivos de texto), risco baixo (tudo legível e auditável), e o investimento real é cultural: o time precisa adotar o ritual de alinhar, testar e revisar em vez de só acelerar. Funciona bem como ponto de partida ou como referência para o time escrever os padrões da própria casa. Pense num checklist de piloto de avião: a aeronave decola sem ele, mas é o checklist que evita o acidente.

Se ninguém na empresa usa agentes de código, ainda não é a sua vez.

Por que está no mapa

Em 2026, 'skills' viraram o formato padrão para empacotar conhecimento de trabalho e entregar a agentes de IA, e este repositório é o exemplo mais popular do gênero: criado em fevereiro de 2026, passava de 199 mil estrelas em agosto, com atualizações constantes. O autor não é um vendedor de promessa, é um engenheiro-educador respeitado mostrando o caderno de bordo dele. O repo marca uma virada importante do momento: a vantagem competitiva deixou de ser 'qual modelo você usa' e passou a ser 'como você ensina o agente a trabalhar do jeito da sua empresa'.

Quem entende isso cedo transforma prática interna em ativo.