A maioria dos devs que usam Claude Code escrevem suas instruções do zero — ou simplesmente não escrevem nenhuma. Matt Pocock acabou de publicar seu diretório .claude completo para que você não precise fazer isso.
mattpocock/skills é uma coleção de skills para Claude Code. Chegou ao #1 do GitHub Trending e está em 75.7K estrelas. A descrição do repositório é direta: “Skills for Real Engineers.” Não é marketing — é um contraste deliberado com o vibe coding, onde você descreve o que quer e espera que o modelo resolva.
Cada skill desta coleção faz exatamente uma coisa.
O que tem na coleção
Os skills estão organizados em quatro áreas:
Planejamento e design — antes de tocar uma linha de código:
write-a-prd— Executa uma entrevista interativa, explora seu codebase e arquiva o PRD resultante diretamente como uma issue do GitHub.prd-to-issues— Pega esse PRD e o divide em issues do GitHub independentes, cortadas em slices verticais.grill-me— Questiona você sobre seu plano até que cada ramificação da árvore de decisão fique resolvida. Útil quando você sabe o que quer construir mas ainda não pensou completamente.
Desenvolvimento — escrever, refatorar, corrigir:
tdd— Loop red-green-refactor. Constrói features ou corrige bugs um slice vertical por vez. Este é o skill central da coleção — TDD primeiro é inegociável no workflow de Pocock.triage-issue— Investiga um bug explorando o codebase, identifica a causa raiz e arquiva uma issue do GitHub com um plano de correção baseado em TDD. Debugging estruturado, não vibear até que algo compile.improve-codebase-architecture— Busca oportunidades de melhoria arquitetônica: módulos rasos, gaps de testabilidade, candidatos a slice vertical.
Tooling e setup:
setup-pre-commit— Configura hooks de pre-commit com Husky, lint-staged, Prettier, type checking e tests.git-guardrails-claude-code— Configura hooks do Claude Code para bloquear comandos git perigosos (push para main,reset --hard,clean, etc.) antes de serem executados.
Writing Skills:
write-a-skill— Cria novos skills usando a mesma estrutura da coleção. Pocock incluiu o meta-skill para que você possa estender o sistema.
Como instalar
O repositório inclui um diretório .claude-plugin, o que significa que funciona diretamente com o sistema de plugins do Claude Code. Clone-o e execute:
claude mcp add mattpocock-skills
Ou copie o diretório skills/ manualmente dentro de seu próprio diretório .claude se preferir controle total sobre o que incluir.
Os skills em si são arquivos de texto plano — legíveis, auditáveis e fáceis de modificar. Sem caixas-pretas.
Por que importa
Pocock é conhecido por ts-reset, total-typescript e anos de educação sobre TypeScript. Não é um criador de ferramentas de IA — é um desenvolvedor que usa Claude Code como parte de seu workflow real e decidiu compartilhar a configuração exata que a torna útil.
Essa procedência importa. Não são prompts aspiracionais escritos para uma demo. São as instruções que um engenheiro ativo usa para que Claude Code não se desvie do caminho — com TDD obrigatório, planejamento estruturado antes de implementar, e guardrails em operações git destrutivas.
O skill git-guardrails-claude-code merece atenção especial para times. Sessões de coding agnóstico acumulam estado rapidamente, e um reset --hard ou um push direto para main de um agente que interpretou mal o contexto é exatamente o tipo de incidente que encerra o experimento para todo um time. Este skill se conecta ao sistema nativo de hooks do Claude Code para interceptar esses comandos antes de serem executados.
O tradeoff a considerar
Estes skills são opinados. O workflow TDD-first é inegociável no setup de Pocock — se seu codebase não tem uma infraestrutura de testes em que você confia, tdd e triage-issue vão se sentir como fricção em vez de estrutura. O mesmo com write-a-prd: arquiva diretamente em GitHub Issues, então você precisa dessa integração funcionando.
Os skills também assumem um certo nível de maturidade do projeto. Estão construídos para codebases com convenções estabelecidas, não para protótipos do zero.
