Mergulho profundo em IA

Mergulho profundo nas habilidades de Matt Pocock: pequenas habilidades de agente para trabalho de engenharia real

O repositório `skills` de Matt Pocock é uma coleção compacta de habilidades de agente para trabalho de engenharia prático: elaborar um plano, escrever documentação, executar TDD, diagnosticar bugs, melhorar a arquitetura, triar problemas, dividir o trabalho em tarefas, criar PRDs, realizar handoffs e configurar projetos.

Atualizado em junho de 2026
Guia de habilidades de Matt Pocock mostrando cartões compactos de habilidades de engenharia para TDD, diagnóstico, documentação, arquitetura, triagem, PRDs e entregas

A postura do repositório é deliberadamente pequena e composta. Ele não tenta substituir o processo de engenharia por um framework de agente gigante. Ele oferece aos agentes hábitos melhores para as partes do trabalho de software que falham rotineiramente: ambiguidade, ciclos de feedback, linguagem de domínio, desvio de arquitetura, testes e qualidade de handoff.

Get the latest on AI, LLMs & developer tools

New MCP servers, model updates, and guides like this one — delivered weekly.

Nota editorial

Este artigo baseia-se no repositório GitHub, README, arquivos de habilidades, scripts de configuração, docs, issues e PRs atuais, listagem skills.sh, link da newsletter e metadados públicos do GitHub coletados em 2 de junho de 2026. Contadores de popularidade exatos são omitidos porque mudam rapidamente.

1. skills em uma frase

O repositório `skills` de Matt Pocock é um conjunto licenciado sob MIT de habilidades de fluxo de trabalho de agente de IA pequenas e adaptáveis para tarefas reais de engenharia de software, como TDD, diagnóstico, esclarecimento de produto, documentação, melhoria de arquitetura, triagem de problemas e handoffs.

ÁreaDetalhePor que importa
Repositóriomattpocock/skillshttps://github.com/mattpocock/skills
Linguagem principalShellLinguagem principal no GitHub no momento da pesquisa.
LicençaMITVerifique separadamente licenças empacotadas ou binárias quando relevante.
Criado3 de fevereiro de 2026Nenhum release do GitHub encontrado durante a pesquisa; a branch principal e as issues estão ativas.

2. Por que importa

O repositório é importante porque muitas falhas de codificação por IA são falhas de processo. O agente entende mal a solicitação, altera muita coisa de uma vez, carece de feedback, ignora a linguagem de domínio ou produz código difícil de manter.

Em vez de uma metodologia enorme, essas habilidades são ferramentas específicas. Você pode executar `/grill-with-docs` antes de uma funcionalidade, `/tdd` durante a implementação, `/diagnose` em um bug, `/improve-codebase-architecture` após o acúmulo de entropia e `/handoff` quando o contexto precisa ser movido.

A postura de engenharia também é notável: o README rejeita o 'vibe coding' vago e enfatiza fundamentos como linguagem compartilhada, red-green-refactor, pequenos passos, feedback, módulos profundos e gestão de design.

3. Arquitetura e modelo mental

O repositório é organizado por categoria de habilidade: engenharia, produtividade, diversos, pessoal, em progresso e obsoletos. Uma pequena habilidade de configuração registra a configuração por repositório, como rastreador de problemas, etiquetas de triagem e localização de docs, para que outras habilidades possam operar de forma consistente.

ÁreaDetalhePor que importa
Instalador`npx skills@latest add mattpocock/skills`Caminho principal de configuração do README através do skills.sh.
Configurar skill`setup-matt-pocock-skills`Captura locais de rastreadores de problemas, etiquetas e documentos usados por outras skills.
Planejamento`grill-with-docs`, `grill-me`, `to-prd`, `to-issues`Clarifica intenção, termos de domínio, decisões, PRDs e fatias de problemas.
Implementação`tdd`, `diagnose`, `prototype`Melhora ciclos de feedback, disciplina de depuração e design exploratório.
Arquitetura`improve-codebase-architecture`, `zoom-out`Encontra pressão de design, aprofunda oportunidades e um contexto de código mais amplo.
Operações`triage`, `handoff`, `git-guardrails-claude-code`, `setup-pre-commit`Suporta estado de issue, transferência de contexto e fluxos de trabalho de repositório mais seguros.
DocumentaçãoFormatos `CONTEXT.md`, `docs/adr/`, `grill-with-docs`Linguagem compartilhada e registros de decisão de arquitetura são de primeira classe.
Scripts`scripts/link-skills.sh`, `scripts/list-skills.sh`Auxiliares de shell locais para listar e vincular habilidades.

4. Menor configuração ponta a ponta

Os comandos abaixo foram copiados da documentação do repositório e conferidos com o snapshot atual da pesquisa. Trate-os como ponto de partida e leia o README vinculado antes de instalar em produção.

# Install through skills.sh
npx skills@latest add mattpocock/skills

# In your agent, select the skills you want.
# Include setup-matt-pocock-skills.

# Then run the setup skill once per repository:
/setup-matt-pocock-skills

Uma primeira tarefa pequena deve provar a integração antes de conectá-la a dados críticos ou workspaces grandes.

# Clarify a feature and update docs/ADRs
/grill-with-docs

# Build the change with a red-green-refactor loop
/tdd

# Diagnose a hard bug
/diagnose

# Break a plan into independently grabbable issues
/to-issues

# Hand off a session to another agent or future context
/handoff

5. Deep dive técnico

5.1 A habilidade de configuração é a dependência silenciosa

O README diz para selecionar `/setup-matt-pocock-skills` durante a instalação e executá-lo antes do restante do fluxo de trabalho de engenharia. Isso não é perda de tempo. Ele registra a escolha do rastreador de problemas, rótulos de triagem e localização da documentação para que habilidades como `to-issues`, `triage` e `grill-with-docs` possam se comportar de forma previsível.

Problemas atuais discutem até mesmo os limites da política de configuração. Isso nos diz que o repositório se preocupa com a repetibilidade em vez de deixar cada habilidade redescobrir as convenções locais.

5.2 Grilling é uma ferramenta de modelagem de requisitos

`grill-me` e `grill-with-docs` são construídos em torno de uma observação simples: os usuários muitas vezes não sabem exatamente o que querem até serem questionados. A habilidade faz com que o agente faça perguntas concretas antes de escrever código.

`grill-with-docs` estende isso para linguagem compartilhada e ADRs. Isso é especialmente útil em produtos reais porque os termos de domínio reduzem explicações verbosas e melhoram nomes, testes e títulos de problemas.

before coding:
  ask hard questions
  define domain terms
  record decisions
  narrow scope
  then implement

5.3 TDD e diagnóstico criam ciclos de feedback

`/tdd` impulsiona os agentes em direção ao red-green-refactor e fatias verticais menores. `/diagnose` impulsiona reproduzir, minimizar, hipotetizar, instrumentar, corrigir e testar regressão.

Essas habilidades não tornam um modelo mais inteligente isoladamente. Elas alteram o loop ao redor do modelo para que ele obtenha melhores evidências antes da edição e melhor verificação após a edição.

5.4 O trabalho de arquitetura é estruturado como gestão de design.

`improve-codebase-architecture` é voltado para bases de código que estão se tornando difíceis de alterar. O README vincula isso a ideias como módulos profundos, linguagem de domínio e investimento diário em design.

Esse é o nível certo de ambição para uma habilidade de agente: não 'reescrever o aplicativo', mas inspecionar a pressão de design, esclarecer interfaces e produzir oportunidades concretas de aprofundamento.

5.5 O repositório intencionalmente não é um monólito.

As habilidades são pequenas o suficiente para serem adaptadas. Isso é importante porque as equipes possuem diferentes rastreadores de problemas, convenções de documentação, ferramentas de teste, linguagem de domínio e tolerância para a autonomia do agente.

A superfície atual de PR e issues mostra que o limite ainda está evoluindo: separação de comandos versus habilidades, melhores saídas de `/teach`, documentação fora de worktrees, comportamento de decomposição de issues e ajuste de frequência de saída.

6. Padrões reais: errado vs certo

ErradoCertoMotivo
Instale todas as habilidades e espere que o agente conheça seu repositório.Execute `/setup-matt-pocock-skills` e configure o rastreador de problemas, rótulos e caminhos de documentação.Várias habilidades dependem de convenções locais.
Use `/tdd` como um rótulo para escrever testes após o fato.Use-o como red-green-refactor em pequenas fatias verticais.O valor está no ciclo de feedback, não apenas nos arquivos de teste.
Peça por melhorias de arquitetura sem documentação de domínio.Construa uma linguagem compartilhada e ADRs primeiro, sempre que possível.A análise de arquitetura melhora quando o agente entende a linguagem do produto.
Trate-os como um framework de agente completo.Trate-os como ferramentas de processo componíveis.O repositório é intencionalmente pequeno e adaptável.

7. Erros comuns e problemas atuais

O issue tracker importa porque estes repositórios são jovens e mudam rápido. O artigo usa issues como sinais de risco, não como prova de que o projeto é inutilizável.

ÁreaDetalhePor que importa
Comandos vs habilidadesO PR #291 rastreia a divisão de habilidades em comandos versus habilidades.A semântica de empacotamento ainda está sendo refinada.
Ensinar habilidadeA Issue #296 solicita uma melhor orientação sobre diagramas de árvore e hierarquia.Algumas habilidades em desenvolvimento ainda estão evoluindo.
Localização da documentaçãoA Issue #294 solicita documentação fora da árvore de trabalho para `grill-with-docs`.Fluxos de trabalho de documentação entre árvores de trabalho precisam de cuidado.
Decomposição de issuesA Issue #292 diz que as issues pai permanecem selecionáveis após a decomposição.Fluxos de trabalho `to-issues` podem precisar de limpeza manual.
Transferência de arquiteturaA Issue #290 solicita botões de transferência nas páginas de arquitetura geradas.Relatórios gerados estão se tornando artefatos de fluxo de trabalho.
Frequência de saídaA Issue #284 abordou a frequência de saída de `grill-with-docs`.Habilidades de entrevista precisam de um ritmo que corresponda ao do usuário.

8. Notas de desempenho, escala e custo

Essas habilidades são majoritariamente texto e processo, portanto, o custo de execução depende do agente e do tamanho do repositório, em vez de uma compilação local pesada. O maior custo de tokens vem de longas sessões de questionamento, análise de arquitetura, decomposição de issues e leituras repetidas da base de código.

A maneira prática de controlar o custo é escolher habilidades específicas. Use `/diagnose` para um bug, `/tdd` para uma fatia, `/to-issues` para um plano e `/handoff` quando o contexto precisar ser comprimido.

O valor do repositório é cumulativo: linguagem compartilhada, ADRs, fatias de issues e transferências reduzem a ambiguidade futura, o que pode economizar mais tokens do que os custos da sessão inicial.

9. Para quem é

Use seEvite se
Você deseja fluxos de trabalho de agentes que preservem a disciplina de engenharia.Você deseja uma estrutura autônoma que controle todo o processo.
Você usa Claude Code, Codex ou agentes compatíveis com reconhecimento de habilidades.Suas ferramentas não conseguem carregar ou adaptar fluxos de trabalho `SKILL.md`.
Sua equipe valoriza TDD, disciplina de depuração, ADRs e higiene de issues.Você só quer geração de código rápida de uma única vez.
Você se sente confortável adaptando pequenas habilidades às convenções do seu repositório.Você precisa de um produto de gerenciamento de projetos totalmente hospedado e opinativo.

10. Sinal da comunidade

O sinal mais forte da comunidade é o público existente de TypeScript e engenharia de IA do mantenedor. O README direciona as pessoas através do skills.sh e de uma grande audiência da newsletter AI Hero, o que dá ao repositório distribuição imediata.

O rastreador de issues é produtivamente opinativo. Muitas issues são perguntas sobre políticas ou fluxos de trabalho, não apenas bugs: verificação de configuração, limites de perguntas, escopo do rastreador de issues, comportamento de issue pai, caminhos de documentação e empacotamento de comandos.

A estrutura do repositório é refrescantemente fundamentada: ela argumenta que os fundamentos importam mais com agentes, e não menos.

11. O veredicto: vale a pena usar?

Nossa opinião

Use as skills de Matt Pocock se você deseja fluxos de trabalho de agentes pequenos e componíveis que tornem o planejamento, testes, diagnóstico, arquitetura, triagem de problemas e handoffs mais disciplinados. Ignore se você quer um framework autônomo de um clique ou um repositório que esconde o processo de engenharia atrás de um único comando.

12. O panorama maior

Este repositório representa uma direção madura para ferramentas de agentes: não agentes maiores, mas melhores rituais em torno dos agentes. A skill é o wrapper de processo que impede que um modelo transforme ambiguidade em código cedo demais.

À medida que a codificação por IA se torna mais rápida, o gargalo muda para julgamento, restrições, feedback e manutenibilidade. Skills pequenas como estas são uma maneira de codificar esses hábitos de engenharia diretamente no fluxo de trabalho do agente.

13. Perguntas frequentes

P: Como instalo as skills de Matt Pocock?

O README recomenda `npx skills@latest add mattpocock/skills`, depois selecionar as skills que você deseja e executar `/setup-matt-pocock-skills`.

P: Elas funcionam apenas com Claude Code?

Elas são escritas como skills de agente e podem ser adaptadas para agentes de codificação compatíveis que reconheçam skills. O comportamento exato da instalação depende do seu agente e do suporte a skills.sh.

P: Com qual skill devo começar?

Comece com `/setup-matt-pocock-skills`, depois use `/grill-with-docs` para novas funcionalidades, `/tdd` para implementação e `/diagnose` para bugs.

P: O que o `/grill-with-docs` faz?

Ele faz perguntas detalhadas sobre a mudança planejada, constrói uma linguagem de domínio compartilhada e pode atualizar documentos de contexto e ADRs.

P: O `/tdd` é apenas para geração de testes?

Não. É um fluxo de trabalho red-green-refactor para implementar pequenas fatias verticais com um ciclo de feedback claro.

P: Eles substituem a gestão de projetos?

Não. Habilidades como `/to-issues`, `/triage` e `/to-prd` podem se integrar a fluxos de trabalho de issues, mas não substituem o julgamento da equipe ou a responsabilidade pelo processo.

14. Glossário

ÁreaDetalhePor que importa
HabilidadeUm fluxo de trabalho `SKILL.md` reutilizável para um agente.O artefato principal do repositório.
Questionamento intensoQuestionamento estruturado antes da implementação.Usado para reduzir a ambiguidade de requisitos.
Linguagem compartilhadaVocabulário de domínio específico do projeto.Armazenado em documentos como `CONTEXT.md`.
ADRRegistro de Decisão de Arquitetura.Captura decisões técnicas importantes.
Red-green-refactorEscreva um teste que falhe, faça-o passar, melhore o design.Ciclo principal de TDD.
Módulo profundoUm módulo com uma interface simples e profundidade interna significativa.Conceito de qualidade de arquitetura.
HandoffTransferência de contexto estruturada para uma sessão ou agente futuro.Reduz a perda de contexto.

15. Todas as fontes e links

Links internos

16. Tabela de atribuição das fontes

ÁreaDetalhePor que importa
READMEPosicionamento, fluxo de instalação, declarações de problemas centrais, mapa de habilidades.Fonte primária.
Arquivos de habilidadeComportamento concreto para configuração, grilling, TDD, diagnóstico, arquitetura, problemas e handoff.Fonte primária.
Scripts e docsVinculação local, listagem, docs de contexto, formatos ADR.Fonte da estrutura do repositório.
Issues e PRsEmpacotamento de comandos, caminho de docs, teach, decomposição de issues e ressalvas de configuração.Sinal de atualização.
skills.shCanal de distribuição e estruturação de instalação.Fonte oficial do ecossistema.

Related Guides