Skills For Real Engineers - Matt Pocock

Coleção de skills de agente do Matt Pocock, uma caixa de ferramentas para engenharia prática em vez de vibe coding

Este repositório é um projeto publicado por Matt Pocock, amplamente conhecido como educador de TypeScript, reunindo as skills de agente para Claude Code que ele usa no dia a dia, ou seja, comandos de barra e regras de comportamento. O slogan é "Skills For Real Engineers", e o autor entende que frameworks como GSD, BMAD e Spec-Kit, que assumem todo o processo, tiram o controle do desenvolvedor e dificultam rastrear defeitos quando eles surgem. Como alternativa, ele propõe uma abordagem em nível de ferramenta: pequena, substituível e combinável com qualquer modelo. De fato, ao abrir o codebase, as skills ficam divididas em buckets sob skills/, como engineering, productivity, misc, personal, in-progress e deprecated, e cada skill é gerenciada como uma unidade independente com seu próprio SKILL.md.

• Simplicidade do caminho de instalação: instala-se com uma única linha, npx skills@latest add mattpocock/skills, e com /setup-matt-pocock-skills é possível configurar de uma vez o tipo de issue tracker, o vocabulário de labels usado na triagem e o local de armazenamento da documentação. Basta executar uma vez por repositório, e as outras skills compartilham essa configuração.

• Intenção de design que organiza quatro modos de falha de agentes: o primeiro é o problema de alinhamento, em que o agente "não consegue criar o que você quer"; grill-me e grill-with-docs forçam uma sessão de entrevista que questiona a intenção até o fim. O segundo é o problema do "agente excessivamente verboso"; cria-se um CONTEXT.md que funciona como um dicionário de termos do domínio, reduzindo ao mesmo tempo o desperdício de tokens e problemas de consistência de nomenclatura. O terceiro é o problema de "o código não funciona"; tdd cuida do loop red-green-refactor, e diagnose assume o loop de depuração que vai da reprodução até o teste de regressão. O quarto é o problema de "o código virar uma bola de lama"; to-prd, zoom-out e improve-codebase-architecture ficam responsáveis por recuperar os limites modulares e a visão de sistema.

• O diferencial na forma de lidar com linguagem compartilhada: indo além de uma simples ajuda de codificação, o projeto dá peso à correspondência explícita de vocabulário entre agente e pessoa. No CONTEXT.md do course-video-manager, apresentado como exemplo, o "problema do momento em que uma aula dentro de uma seção dentro de um curso ganha um lugar no sistema de arquivos" é condensado em uma única expressão, "materialization cascade", de modo a reduzir simultaneamente o custo de tokens e o custo cognitivo sempre que a mesma conversa se repete.

• Praticidade das skills secundárias: para o workflow diário, há caveman (modo de resposta comprimida que mira uma redução de cerca de 75% nos tokens) e write-a-skill (uma meta skill para criar a própria skill). O conjunto de ferramentas auxiliares também inclui git-guardrails-claude-code (configuração de hooks para bloquear previamente comandos perigosos de git) e setup-pre-commit (configuração de pre-commit baseada em Husky + lint-staged), dividindo em pequenas ferramentas até mesmo áreas fora da escrita de código.

• As próprias regras operacionais do repositório: skills colocadas em engineering, productivity e misc precisam obrigatoriamente ser registradas no README de nível superior e em .claude-plugin/plugin.json, enquanto o registro é proibido para personal, in-progress e deprecated, impondo o escopo de publicação no nível do código. A existência de documentos ADR em um diretório separado e de scripts shell para linkar skills em scripts/ também pode ser lida como extensão dessa mesma disciplina.

No geral, este projeto mantém distância da automação integrada no estilo "o agente resolve tudo sozinho" e se aproxima mais de uma decomposição, em unidades pequenas e substituíveis de comandos de barra, de princípios clássicos de engenharia como Pragmatic Programmer, Domain-Driven Design, Extreme Programming e A Philosophy of Software Design. Para quem esperava uma ferramenta chamativa de automação de workflow, ele pode parecer um tanto discreto, mas tem uma pegada mais próxima do trabalho real justamente por tentar trazer para as ferramentas do dia a dia, mesmo na era dos agentes, fundamentos como alinhamento, linguagem compartilhada, loops de feedback e design modular.