Guia completo do Skills For Real Engineers: a biblioteca de skills de agentes de IA de Matt Pocock

O que é Skills For Real Engineers

Resposta em uma frase: Skills For Real Engineers (repositório Matt Pocock Skills) é uma biblioteca de skills para agentes de IA criada por Matt Pocock para engenheiros profissionais, originada da prática diária de Matt Pocock no diretório .claude.

O posicionamento é claro: não é um brinquedo de vibe coding, e sim uma caixa de ferramentas diária para fazer "engenharia de verdade". O autor afirma que criou essas skills para corrigir os modos de falha comuns que ele encontra repetidamente em agentes de codificação como Claude Code e Codex.

Diferenças em relação a GSD e BMAD

Métodos como GSD, BMAD e Spec-Kit tentam "assumir o processo" para ajudar. Ao fazer isso, eles também tiram o seu controle e tornam difícil resolver bugs no próprio processo. Skills For Real Engineers segue o caminho oposto:

• Pequeno e bem feito: cada skill funciona de forma independente, sem framework monolítico.
• Combinável: escolha o que precisa e adapte livremente ao seu repositório.
• Hackeável: as skills são arquivos comuns dentro do seu repositório; se não entender, edite.
• Independente de modelo: não fica preso a um modelo específico; funciona com Claude, Codex, Cursor etc.
• Engenharia nativa: baseado em princípios clássicos de engenharia, como The Pragmatic Programmer e Domain-Driven Design, em vez de uma pilha de truques de prompt.

Posicionamento do produto

Voltado para desenvolvedores que já têm hábitos reais de engenharia: usar feedback real — tipos estáticos, testes automatizados, red-green-refactor — para limitar o agente e evitar que ele "voe às cegas". A biblioteca em si não oferece serviço hospedado nem decide a arquitetura por você; ela fornece apenas um conjunto reutilizável de interfaces de conversa e fluxo.

Funcionalidades principais

As skills são oferecidas ao agente como comandos de barra (slash commands), divididos em alguns grupos.

Alinhamento de requisitos

• /grill-me: sessão de questionamento intenso para alinhar totalmente requisitos e ramificações de decisão antes de codificar; também serve para cenários fora de código.
• /grill-with-docs: além do grilling, ajuda a construir a linguagem compartilhada do projeto e registros de decisão de arquitetura (ADRs).
• /zoom-out: pede que o agente saia do código local e explique a partir de uma visão sistêmica do conjunto.

Desenvolvimento e validação

• /tdd: conduz o agente pelo ciclo red-green-refactor, construindo funcionalidades ou corrigindo defeitos um slice vertical de cada vez.
• /diagnose: ciclo de diagnóstico padronizado — reproduzir → minimizar → hipótese → instrumentar → corrigir → teste de regressão.
• /prototype: cria rapidamente protótipos de terminal executáveis ou múltiplas variantes de UI para validar o design.

Tarefas e planejamento

• /triage: faz a triagem e a distribuição de issues com base em uma máquina de estados, com suporte a vocabulário de tags personalizado.
• /to-prd: sintetiza automaticamente o contexto da conversa atual em um PRD e o envia como issue do GitHub.
• /to-issues: divide um plano ou PRD em tarefas de slices verticais que podem ser assumidas de forma independente.

Arquitetura e colaboração

• /improve-codebase-architecture: identifica oportunidades de aprofundamento de módulos com base no CONTEXT.md e em ADRs, tratando a bola de lama arquitetural.
• /caveman: modo de comunicação ultracompacto que reduz o consumo de tokens em cerca de 75% mantendo a precisão técnica.
• /handoff: compacta a sessão atual em um documento de handoff para que outros agentes continuem o trabalho sem atrito.
• /teach: usa o diretório atual como espaço de ensino com estado, ensinando novas habilidades ou conceitos em várias sessões.
• /write-a-skill: cria novas skills seguindo uma estrutura padronizada, com divulgação progressiva e empacotamento de recursos.

Mecanismo de linguagem compartilhada

Criar um sistema de terminologia do projeto por meio do CONTEXT.md é a técnica que o autor mais valoriza neste conjunto. O fenômeno observado: os agentes costumam ser colocados direto no projeto e precisam adivinhar o jargão do domínio pelo caminho — então algo que poderia ser explicado com 1 palavra acaba sendo dito com 20.

Por exemplo, trocar "há um problema quando uma lesson dentro de uma section de um curso é tornada 'real' (ou seja, ganha um lugar no sistema de arquivos)" por "há um problema com a materialization cascade" economiza muito esforço de explicação em uma frase, e essa concisão rende juros sessão após sessão. A linguagem compartilhada também traz outros benefícios: variáveis, funções e arquivos são nomeados de forma consistente usando a linguagem compartilhada; o codebase fica mais fácil de navegar para o agente; e o agente gasta menos tokens ao pensar, porque tem acesso a uma linguagem mais concisa.

Como usar Skills For Real Engineers

Existem dois caminhos de entrada, que correspondem a duas filosofias; escolha apenas um.

Caminho 1: plugin do Claude Code

• O conjunto completo de skills é instalado como um pacote gerenciado e somente leitura, que é atualizado automaticamente quando o autor publica — ou seja, você assina em vez de dar fork.
• Ele já está no marketplace oficial do Claude Code: não é preciso adicionar fonte, e as atualizações chegam sozinhas.
• Um plugin nativo para Codex está no roadmap (veja .agents/adr/0002-ship-as-a-claude-code-plugin.md).

Caminho 2: instalador de skills

Execute npx skills@latest add mattpocock/skills, escolha o agente de destino e marque /setup-matt-pocock-skills. O instalador permite escolher quais skills levar e em quais agentes de codificação instalá-las. As skills são gravadas no seu repositório como arquivos comuns, que você possui e pode editar; nada é atualizado por trás. Quando quiser, use npx skills update para puxar as mudanças mais recentes.

Atenção: instalar pelos dois caminhos ao mesmo tempo deixa cada skill duplicada.

Inicialização e ritmo diário

1. Execute /setup-matt-pocock-skills uma vez no agente, uma vez por repositório. Ele vai perguntar: qual rastreador de issues usar (GitHub, Linear ou arquivos locais); quais tags aplicar na triagem (o /triage depende dessas tags); e onde salvar os documentos criados.
2. Antes de cada mudança, use /grill-me ou /grill-with-docs para alinhar os requisitos.
3. Durante o desenvolvimento, use /tdd para garantir qualidade.
4. Ao encontrar um bug, use /diagnose para iniciar o diagnóstico padronizado.
5. Na manutenção de arquitetura, execute /improve-codebase-architecture regularmente para evitar a deterioração do código.

Toda a instalação e configuração leva cerca de 30 segundos, com suporte a GitHub, Linear ou arquivos locais como rastreador de issues.

Cenários de uso

• Alinhamento e planejamento de requisitos: no início de um projeto ou antes de mudar uma funcionalidade, use /grill-me ou /grill-with-docs para um questionamento intenso com o agente, garantindo que os dois lados estejam totalmente alinhados sobre requisitos, ramificações de decisão e terminologia do domínio.
• Desenvolvimento orientado a testes: quando precisar garantir a qualidade do código, use /tdd para conduzir o agente pelo ciclo red-green-refactor, construindo funcionalidades ou corrigindo defeitos um slice vertical por vez, com testes automatizados protegendo cada mudança.
• Diagnóstico de bugs complexos: ao enfrentar regressões de performance difíceis de reproduzir ou defeitos lógicos, use /diagnose para percorrer o ciclo completo de diagnóstico.
• Governança contínua de arquitetura: em codebases grandes e de manutenção de longo prazo, execute /improve-codebase-architecture regularmente, identificando oportunidades de aprofundamento de módulos com base no CONTEXT.md e nos ADRs, para evitar que o agente acelere a deterioração e manter o sistema sustentável.
• Colaboração entre sessões: use /handoff para compactar a sessão e /caveman para reduzir tokens — indicado para tarefas longas e trabalho em equipe com vários agentes.

Vantagens

• Leve e combinável: recusa frameworks pesados; cada skill funciona de forma independente e pode ser adaptada livremente.
• Independente de modelo: funciona com Claude, Codex, Cursor etc.
• Engenharia nativa: construído sobre princípios clássicos de engenharia, e não truques de prompt.
• Mecanismo de linguagem compartilhada: o CONTEXT.md reduz de forma significativa o custo de comunicação e o consumo de tokens do agente.
• Ciclo de feedback: prioriza feedback real, como tipos estáticos, testes automatizados e red-green-refactor.
• Fácil de modificar: no caminho de skills, elas são arquivos editáveis dentro do seu repositório.

Limitações

• É um conjunto de skills, não um gerenciador de fluxo ponta a ponta; times sem disciplina de linguagem compartilhada e ADRs precisam manter o CONTEXT.md e os registros de decisão por conta própria.
• O sistema de tags do /triage depende da configuração feita na inicialização; uma configuração inadequada afeta a qualidade da triagem.
• Os dois caminhos de instalação são mutuamente exclusivos; misturar os dois gera skills duplicadas.
• O plugin nativo para Codex ainda está no roadmap; usuários de Codex usam, por enquanto, o caminho de instalação por arquivos de skill.
• O escopo de suporte, os detalhes dos comandos e o ritmo de atualizações podem mudar.

Nota de verificação de preço e disponibilidade

A tabela de fatos desta publicação não trouxe nenhuma informação sobre preço, assinatura ou termos de licença; portanto, não fazemos suposições. Para saber se há cobrança, qual é o modelo de licença, quais canais de instalação estão disponíveis e qual é o estado da versão mais recente, consulte diretamente o site oficial em https://github.com/mattpocock/skills e a página oficial do marketplace de plugins do seu agente antes de decidir.

Perguntas frequentes (FAQ)

Ele fica vinculado a algum modelo?

Não. A descrição oficial é que ele é independente de modelo; pode ser usado com Claude, Codex, Cursor etc.

Dá para usar logo depois de instalar?

Ainda é preciso inicializar. Execute /setup-matt-pocock-skills uma vez no agente, configurando o rastreador de issues, as tags de triagem e o diretório de documentos; só depois disso skills como /triage funcionarão de acordo com as suas convenções.

Devo escolher o plugin ou o instalador?

Se você quer acompanhar as atualizações do autor e aceitar um pacote gerenciado somente leitura, escolha o plugin do Claude Code; se quer possuir e modificar os arquivos e controlar o momento das atualizações, use npx skills@latest add mattpocock/skills. Não instale os dois ao mesmo tempo.

Ele conflita com GSD e BMAD?

A intenção de design do autor é oferecer uma alternativa: GSD, BMAD e Spec-Kit ajudam ao assumir o processo, mas, ao mesmo tempo, tiram o seu controle e deixam os problemas do processo difíceis de resolver. Este conjunto opta por skills pequenas, combináveis e hackeáveis. Misturar ou não as abordagens depende da disciplina do seu time.

Qual skill vale mais a pena testar primeiro?

O autor considera que /grill-with-docs pode ser a técnica mais forte de todo o repositório: é ao mesmo tempo uma sessão de questionamento e uma forma de construir com a IA uma linguagem compartilhada do projeto, registrando em ADRs as decisões difíceis de explicar.

Alternativas

• GSD, BMAD, Spec-Kit: frameworks pesados que tentam assumir o processo de desenvolvimento; você tem menos controle e problemas no processo ficam mais difíceis de localizar.
• Agent Skill de código aberto do desenvolvedor 一泽 Eze: focada em "pensar em como acessar a internet".
• Framework de skills agênticas e plugin de metodologia de desenvolvimento de software, ambos de código aberto, por Jesse Vincent.
• Skill de design de IA de código aberto, projetada para assistentes de codificação de IA.
• Abordagem geral: manter seu próprio conjunto de arquivos de skill em .claude ou no nível do projeto, montado conforme os hábitos do time.

Fontes primárias

• Site oficial e repositório do produto: https://github.com/mattpocock/skills

Se você quiser acompanhar as mudanças nessas skills e nas novas que o autor criar, pode entrar na newsletter dele, que já reúne cerca de 60.000 desenvolvedores.