Skills de Matt Pocock no Claude Code: do plano ao código

Matt Pocock, conhecido pelos cursos de TypeScript, mantém no GitHub o repositório mattpocock/skills, com a descrição "Skills for Real Engineers". É uma coleção de skills: pequenos arquivos de instruções que o agente de IA carrega quando você chama um comando, como /grill-me. A ideia central do autor é que o erro mais comum com agentes é a falta de alinhamento: você acha que a IA entendeu o que você quer e só descobre o contrário depois de ver o resultado.

Para resolver isso, o repositório organiza o trabalho em etapas. Primeiro vem uma sessão de perguntas, chamada de grilling, em que o agente questiona você sobre o plano. Depois o conteúdo vira uma especificação, a especificação vira uma lista de tarefas, e só então o agente implementa. O próprio README diz que as skills são pequenas, adaptáveis e funcionam com qualquer modelo, em vez de impor um processo fechado.

Os nomes abaixo foram conferidos na pasta do repositório. Na pasta skills/productivity existem: grill-me, grilling, handoff, teach, to-questionnaire, wait-what e writing-for-agents. Na pasta skills/engineering existem: ask-matt, code-review, codebase-design, diagnosing-bugs, domain-modeling, grill-with-docs, implement, implement-spec, improve-codebase-architecture, pr, prototype, research, retro, setup-matt-pocock-skills, tdd, to-spec, to-tickets, triage, wayfinder e wizard.

O README separa as skills em dois tipos. As que só você chama digitando o comando, como grill-me, to-spec, to-tickets e implement, servem para orquestrar. As que o agente também pode acionar sozinho, como tdd, code-review e diagnosing-bugs, guardam a disciplina reutilizável. Isso segue o funcionamento descrito na documentação oficial do Claude Code: cada skill é uma pasta com um arquivo SKILL.md, e o campo disable-model-invocation: true impede que o Claude a carregue sozinho.

A skill /grill-me é para qualquer plano, inclusive fora de programação. Ela manda o agente entrevistar você até resolver cada ramo das decisões, e o texto da skill pede que ele sugira uma resposta para cada pergunta. Para código, o README indica a /grill-with-docs, que faz o mesmo e ainda atualiza o glossário do projeto (GLOSSARY.md) e registros de decisões de arquitetura (ADRs). Em seguida, /to-spec transforma a conversa em especificação, sem nova entrevista, e a publica no gerenciador de tarefas do projeto.

Para instalar no Claude Code, o README oficial dá um único comando: claude plugin install mattpocock-skills@claude-plugins-official. Segundo o README, o plugin se atualiza sozinho. Para outros agentes, como Cursor, OpenCode ou Windsurf, o comando é npx skills@latest add mattpocock/skills, e o instalador deve incluir a skill setup-matt-pocock-skills. O autor avisa para escolher só um método por agente: instalar plugin e cópia manual juntos duplica todas as skills.

Depois de instalar, rode /setup-matt-pocock-skills uma vez em cada repositório. Ela pergunta qual gerenciador de tarefas você usa (GitHub, GitLab, arquivos locais ou outro), quais rótulos usa na triagem e onde guardar a documentação. Pela documentação oficial do Claude Code, skills de plugin aparecem com o nome do plugin na frente, no formato /nome-do-plugin:nome-da-skill. Se /grill-me não aparecer sozinho, digite / e procure pela lista.

Um fluxo possível, montado a partir das descrições das skills (o README não traz uma sequência única): 1) rode /grill-with-docs e descreva o que quer construir; 2) rode /to-spec para publicar a especificação; 3) rode /to-tickets para quebrá-la em tarefas pequenas, cada uma indicando quais bloqueiam as outras; 4) rode /implement para um conjunto de tarefas, ou /implement-spec para a especificação inteira, em que subagentes trabalham as tarefas prontas em paralelo e o resultado passa por /code-review; 5) rode /pr para escrever a descrição do pull request.

Cuidados. O repositório usa licença MIT, de código aberto de verdade, e você pode copiar e adaptar. Mas as skills são instruções que o agente vai seguir, e as de implementação podem criar tarefas no seu gerenciador, editar arquivos e fazer commits. Leia o SKILL.md de qualquer skill antes de usá-la e teste primeiro num repositório sem importância. O Claude Code e as ferramentas dos outros agentes têm planos e custos próprios: confira na página oficial de cada um.

Resumindo: o post do Instagram acertou ao dizer que as skills entrevistam, especificam, dividem em tarefas e só depois implementam. Comece pequeno: instale o plugin, rode /grill-me ou /grill-with-docs sobre uma ideia sua e veja que buracos aparecem no plano. Se gostar, avance para /to-spec e /to-tickets. A /ask-matt também ajuda: ela indica qual skill ou fluxo serve para a sua situação.