matt-pocock-skills

Matt Pocock’s Skills

Overview

Matt Pocock’s Skills é um toolkit leve e composável de agent skills para coding, liberado open-source a partir de seu diretório pessoal .claude. Em contraste com frameworks que impõem um pipeline, Matt oferece skills pequenas e independentes que o usuário invoca manualmente quando necessário — assumindo que engenheiros experientes sabem quando a disciplina é necessária.

Key Facts

• Filosofia: “toolset composável” — o humano decide quando aplicar disciplina, não o sistema
• Skills invocáveis via comando: /grill, /handoff, /to-tickets, /diagnosing-bugs, /tdd etc.
• Pragmatismo sobre dogma: inspiração de “The Pragmatic Programmer”, Kent Beck, John Ousterhout
• Subagentes paralelos: capaz de rodar 10 agentes em paralelo no mesmo codebase, cada um em seu Git worktree isolado
• Destaque das skills: grill-with-docs (pressure-test de requisitos), handoff (continuidade entre sessões), to-tickets (trabalho decomposto em bullets), tdd (ciclo red-green com refatoração separada)
• Adoção: ~208.547★; recepção da comunidade consistentemente positiva, enxergado como alternativa “just enough”
• Pontos fracos documentados: carga alta do operador (invocação manual), perda de detalhes finos no handoff, colisões de comandos quando rodado simultaneamente com Superpowers

Relationships

• “operates-with” claude-code — toolkit primariamente para Claude Code (flagship)
• “differs-from” superpowers — toolset composável vs disciplina imposta; manual vs automático
• “references” external-skills-ecosystem — parte do ecossistema mais amplo de agent skills

Implications

Matt Pocock resolve o problema de engenheiros experientes que sabem quando querem disciplina — mas não querem pagar o custo de um pipeline completo toda sessão. O trade-off é a carga cognitiva do operador: alguém precisa saber qual skill invocar e quando. A melhor aplicação é para quem já entende os modos de falha do agente e quer um bisturi, não uma fábrica.

Open Questions

• A carga de operador manual escala bem para equipes, ou é ideal para uso individual?
• O handoff perde decisões sutis de sessões longas — isso é um ceiling ou será corrigido?

Deep research (dados atualizados, 2026-08-07)

Métricas confirmadas via GitHub API no dia da pesquisa:

• ~208.547⭐ / ~18k forks / ~302 issues (2026-08-07)
• 38 skills — combinam invocadas manualmente (/cmd) + core do modelo
• Suporte de multi-harness: flagship Claude Code, com install editável para outros

Voz da comunidade por plataforma

• Hacker News: Bossie — “heavily rely on Matt Pocock’s Skills and Sandcastle… highly valuable in practice”; wccrawford — “designed to be called by the user instead of called automatically, and that makes a difference”; pipes — “grill-me e tdd me ajudaram massivamente”.
• Show HN (ecossistema): NAWC, chartr wayfinder visualizer, Architect-MCP/grill-me, “The Order of the Agents” — todos derivam explicitamente.
• YouTube: “5 Claude Code skills I use every day”; Full skills walkthrough — ideação → plan → spec → tickets → implement em uma janela.

Dores reais (GitHub issues)

• #799 (race condition na numeração de ADRs); #809 (/implement colide com /code-review nativa); #802 (subagente de grilling confunde o agente principal); #794 (wayfinder “fumbles” a navegação).

Projetos de fusão

• Utilizado em devflow (grill + Matt ADRs → Superpowers brainstorm/planning), oh-my-opencode, lean-skills, letttgaco, ryanuo. Migração de Superpowers para Matt observada em Token-Effort, agentic-code-stack, agentbase — citado por perda de peso e flexibilidade.

README oficial — 4 failure modes + arquitetura de skills (2026-08-07)

O README articula as skills em torno de 4 modos de falha do agente de código, cada um com um fix correspondente:

#	Modo de falha	Fix	Skills-chave
1	Agente não faz o que você quer (alinhamento)	Grilling session — entrevista para refinar o que se quer	grill-me, grill-with-docs
2	Agente verboso demais (linguagem dispersa)	Shared language — CONTEXT.md + glossário de domínio	grill-with-docs (CONSText.md + ADRs)
3	Código não funciona (feedback fraco)	TDD + diagnosing — red-green loop + diagnóstico disciplinado	tdd, diagnosing-bugs
4	Projeto vira “ball of mud” (complexidade)	Arquitetura — revisão de design e deepening	improve-codebase-architecture, to-spec

Arquitetura de skills (do README):

Skills se dividem em dois eixos:

• User-invoked (você digita o comando): ask-matt, grill-me, grill-with-docs, triage, improve-codebase-architecture, setup-matt-pocock-skills, to-spec, to-tickets, implement, wayfinder
• Model-invoked (o agente chama sozinho quando o task combina): prototype, diagnosing-bugs, research, tdd, domain-modeling, codebase-design, code-review, resolving-merge-conflicts, wizard

Essa dicotomia é o que torna o toolkit composable: user-invoked orquestra; model-invoked fornece disciplina reutilizável.

Productivity skills adicionais: grill-me, handoff, teach, to-questionnaire, wait-what, writing-for-agents.

Repositório e links

• GitHub: https://github.com/mattpocock/skills (MIT, ~208k★)
• Site: mattpocock.com / aihero.dev
• Newsletter: skills newsletter (~60k devs)
• Instalação: claude plugins install mattpocock-skills (plugin oficial) ou npx skills@latest add mattpocock/skills (editável)

Sources

^[raw/papers/disciplined-execution-vs-flexible-tooling.md]