skills

Skills for Real Engineers é um repositório de Matt Pocock que reúne habilidades de agentes usadas no dia a dia da engenharia de software com agentes de codificação por IA. Ele é compartilhado a partir do diretório .agents do autor e foi projetado para ser pequeno, adaptável, composável e independente de modelo. O autor diferencia essas habilidades de abordagens maiores que assumem o controle do processo, como GSD, BMAD e Spec-Kit, argumentando que elas tiram o controle do desenvolvedor; já essas habilidades buscam se integrar aos fluxos de trabalho existentes. A instalação oferece dois caminhos: um plugin do Claude Code instala o conjunto completo como um pacote gerenciado, somente leitura e com atualizações automáticas, enquanto o instalador skills.sh copia arquivos de habilidades editáveis para o projeto, permitindo que os usuários os modifiquem. Após a instalação, uma habilidade de configuração (setup-matt-pocock-skills) é executada uma vez por repositório para configurar o rastreador de problemas (GitHub, Linear ou arquivos locais), rótulos de triagem e a localização da documentação. A motivação declarada do repositório é corrigir modos comuns de falha em agentes de codificação: - Desalinhamento entre o que o usuário deseja e o que o agente constrói, abordado por sessões de questionamento que interrogam o plano antes do início do trabalho (grill-me, grill-with-docs). - Saída excessivamente verbosa do agente, abordada pela construção de uma linguagem de domínio compartilhada documentada em CONTEXT.md e ADRs, para que os agentes raciocinem e se comuniquem de forma mais concisa. - Código que não funciona, abordado por meio de ciclos de feedback: tipos estáticos, acesso ao navegador e testes automatizados, incluindo uma habilidade de TDD red-green-refactor e um ciclo de diagnóstico de bugs em fases. - Degradação da arquitetura, abordada por habilidades focadas em design que incentivam módulos profundos e avaliações regulares da arquitetura da base de código. As habilidades estão organizadas em duas categorias principais: Habilidades de engenharia incluem comandos invocados pelo usuário, como ask-matt (um roteador sobre as habilidades), grill-with-docs, triage, improve-codebase-architecture, to-spec, to-tickets, implement e wayfinder. Habilidades de engenharia invocadas pelo modelo incluem prototype, diagnosing-bugs, research, tdd, domain-modeling, codebase-design, code-review, resolving-merge-conflicts e wizard. Habilidades invocadas pelo modelo podem ser chamadas automaticamente pelo agente quando apropriado; habilidades invocadas pelo usuário orquestram fluxos de trabalho e podem invocar as habilidades invocadas pelo modelo. Habilidades de produtividade, utilizáveis além da codificação, incluem comandos invocados pelo usuário como grill-me, handoff, teach, to-questionnaire e wait-what, além do primitivo reutilizável de entrevista grilling e writing-for-agents para produzir documentação legível por agentes, como AGENTS.md e CLAUDE.md. O autor oferece uma newsletter para manter os usuários atualizados sobre mudanças nas habilidades. O repositório também documenta decisões de design, incluindo uma sobre o lançamento como plugin do Claude Code, em um diretório ADR. No geral, trata-se de uma biblioteca prática de práticas de engenharia repetíveis codificadas como comandos de barra e habilidades chamáveis por agentes, voltada para desenvolvedores que desejam mais controle sobre como agentes de IA escrevem software.