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.
| Área | Detalhe | Por que importa |
|---|---|---|
| Repositório | mattpocock/skills | https://github.com/mattpocock/skills |
| Linguagem principal | Shell | Linguagem principal no GitHub no momento da pesquisa. |
| Licença | MIT | Verifique separadamente licenças empacotadas ou binárias quando relevante. |
| Criado | 3 de fevereiro de 2026 | Nenhum 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.
| Área | Detalhe | Por 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ção | Formatos `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-skillsUma 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
/handoff5. 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 implement5.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
| Errado | Certo | Motivo |
|---|---|---|
| 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.
| Área | Detalhe | Por que importa |
|---|---|---|
| Comandos vs habilidades | O PR #291 rastreia a divisão de habilidades em comandos versus habilidades. | A semântica de empacotamento ainda está sendo refinada. |
| Ensinar habilidade | A 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ção | A 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 issues | A 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 arquitetura | A 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ída | A 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 se | Evite 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
| Área | Detalhe | Por que importa |
|---|---|---|
| Habilidade | Um fluxo de trabalho `SKILL.md` reutilizável para um agente. | O artefato principal do repositório. |
| Questionamento intenso | Questionamento estruturado antes da implementação. | Usado para reduzir a ambiguidade de requisitos. |
| Linguagem compartilhada | Vocabulário de domínio específico do projeto. | Armazenado em documentos como `CONTEXT.md`. |
| ADR | Registro de Decisão de Arquitetura. | Captura decisões técnicas importantes. |
| Red-green-refactor | Escreva um teste que falhe, faça-o passar, melhore o design. | Ciclo principal de TDD. |
| Módulo profundo | Um módulo com uma interface simples e profundidade interna significativa. | Conceito de qualidade de arquitetura. |
| Handoff | Transferência de contexto estruturada para uma sessão ou agente futuro. | Reduz a perda de contexto. |
15. Todas as fontes e links
Fontes primárias
Habilidades principais
Issues e PRs
Autor e Comunidade
Links internos
- Dominando as Habilidades do Agent TARS
- Guia de Habilidades de Pesquisa Acadêmica
- Guia de Melhores Práticas do Claude Code
16. Tabela de atribuição das fontes
| Área | Detalhe | Por que importa |
|---|---|---|
| README | Posicionamento, fluxo de instalação, declarações de problemas centrais, mapa de habilidades. | Fonte primária. |
| Arquivos de habilidade | Comportamento concreto para configuração, grilling, TDD, diagnóstico, arquitetura, problemas e handoff. | Fonte primária. |
| Scripts e docs | Vinculação local, listagem, docs de contexto, formatos ADR. | Fonte da estrutura do repositório. |
| Issues e PRs | Empacotamento de comandos, caminho de docs, teach, decomposição de issues e ressalvas de configuração. | Sinal de atualização. |
| skills.sh | Canal de distribuição e estruturação de instalação. | Fonte oficial do ecossistema. |
Get the Ultimate Antigravity Cheat Sheet
Join 5,000+ developers and get our exclusive PDF guide to mastering Gemini 3 shortcuts and agent workflows.
Related Guides
Humanizer Skill Guide
blader/humanizer: 29 AI-writing patterns, voice calibration, and a two-pass audit, all in one Claude Code skill.
Guides & FeaturesMastering Agent Skills
The open standard for portable AI agent expertise.
Guides & FeaturesAntigravity Workflows Guide
Create automation recipes with Turbo Mode and AgentKit 2.0.
Guides & FeaturesHow to Change Antigravity Themes
Customize themes, dark mode, icons, and color schemes.
Guides & FeaturesHow to Change Language
Switch Antigravity to Spanish, German, Japanese, and more.
Guides & FeaturesAntigravity Security Guide
Known vulnerabilities, safe settings, and hardening steps.
