mattpocock/ask-matt

Pergunte qual skill ou fluxo se adequa à sua situação. Um roteador sobre as skills neste repositório.

O que é ask-matt?

Esta skill atua como um roteador inteligente sobre todas as outras skills disponíveis no repositório. Em vez de decorar cada skill ou fluxo, o usuário simplesmente pergunta qual caminho seguir, e a skill recomenda a melhor rota com base no contexto atual — seja iniciar um novo projeto, depurar um bug, revisar código ou refinar uma ideia. Ela organiza as skills em três categorias principais: o fluxo principal ("ideia → entrega"), rampas de entrada ("bugs e solicitações" e "algo quebrou") e skills independentes ("grill-me", "pesquisa", "protótipo"). Também gerencia a higiene de contexto, recomendando handoffs quando a janela de contexto fica cheia, e fornece um vocabulário subjacente por meio de skills de "modelagem de domínio" e "design de codebase". É suportada em qualquer plataforma que possa executar skills markdown (Claude Code, Cursor, Codex, etc.) e depende de um comando de configuração inicial para preparar o rastreador de issues e layout de documentos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/ask-matt

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Pergunte ao Matt

Você não se lembra de todas as skills, então pergunte.

Um fluxo é um caminho através das skills. A maioria dos caminhos percorre um fluxo principal e duas rampas de entrada que se fundem a ele. Todo o resto é independente ou uma camada de vocabulário que roda subjacente.

O fluxo principal: ideia → entrega

A rota pela qual a maioria do trabalho passa. Você tem uma ideia e quer que ela seja construída.

  1. /grill-with-docs — aprimore a ideia por meio de entrevista. Comece aqui quando você tem um codebase: é stateful, retendo o que aprende em CONTEXT.md e ADRs. (Sem codebase? Use /grill-me — veja Independentes. Ambos executam a mesma primitiva /grilling; grill-with-docs é aquele que deixa um rastro documental.)

  2. Ramificação — você consegue resolver todas as perguntas em conversa? Se uma pergunta precisa de uma resposta executável (estado, lógica de negócio, uma UI que você precisa ver), desvie por um protótipo, conectado por /handoff em ambas as direções (veja Cruzando sessões):

    • /handoff para fora, então abra uma nova sessão contra aquele arquivo,
    • /prototype para responder à pergunta com código descartável,
    • /handoff de volta com o que aprendeu, e referencie-o a partir do tópico da ideia original.
  3. Ramificação — isso é uma construção de múltiplas sessões?

    • Sim → /to-prd (transforme o tópico em um PRD) → /to-issues (divida o PRD em issues independentemente selecionáveis). Como as issues são independentes, limpe o contexto entre cada uma: inicie uma nova sessão por issue e execute /implement passando o PRD e a única issue para trabalhar.
    • Não → /implement aqui mesmo, na mesma janela de contexto.

    De qualquer forma, /implement constrói cada issue dirigindo /tdd internamente — uma fatia vermelho-verde de cada vez — e depois finaliza executando /code-review, uma revisão em dois eixos (Padrões + Especificação) do diff, antes de commitar. Recorra a /tdd por conta própria quando você só quiser construir um comportamento concreto test-first sem uma especificação completa, e /code-review por conta própria sempre que quiser revisar um branch ou PR contra um ponto fixo.

Higiene de contexto

Mantenha os passos 1–3 em uma janela de contexto ininterrupta — não compacte ou limpe até depois de /to-issues — para que a entrevista, o PRD e as issues sejam construídos sobre o mesmo raciocínio. Cada /implement então começa do zero, trabalhando a partir da issue.

O limite para isso é a zona inteligente: a janela (~120k tokens em modelos de ponta) dentro da qual o modelo ainda raciocina com clareza. Se uma sessão se aproximar desse limite antes de /to-issues, não force com qualidade degradada — use /handoff e continue em um novo tópico.

Rampas de entrada

Uma situação inicial que gera trabalho e depois se funde ao fluxo principal.

  • Bugs e solicitações se acumulando → /triage. Ela move issues através de funções de triagem e produz issues prontas para agente, que /implement depois coleta.

    A triagem é apenas para issues que você não criou — relatórios de bug, solicitações de funcionalidade recebidas, qualquer coisa que chegue bruta. Issues que /to-issues produziu já estão prontas para agente, então não as trie.

  • Algo quebrou → /diagnosing-bugs. Para os difíceis: o bug que resiste a um primeiro olhar, a falha intermitente, a regressão que se insinuou entre dois estados conhecidamente bons. Ela se recusa a teorizar até ter um ciclo de feedback apertado — um comando que já falha neste bug — e então corrige com um teste de regressão. Sua análise post-mortem repassa para /improve-codebase-architecture quando a verdadeira descoberta é que não há uma boa junção para fixar o bug.

Saúde do codebase

Não é trabalho de funcionalidade — é manutenção.

  • /improve-codebase-architecture — execute sempre que tiver um momento livre para manter o codebase bom para agentes operarem. Ela revela oportunidades de aprofundamento; escolher uma gera uma ideia que você pode levar para o fluxo principal em /grill-with-docs. É o levantamento que encontra os candidatos; /codebase-design (abaixo) é a bancada onde você projeta o escolhido.

Vocabulário subjacente

Duas referências invocadas pelo modelo que rodam abaixo das outras skills — cada uma é a fonte única de verdade para seu vocabulário. Recorra a elas diretamente quando as palavras, não o processo, são o problema; ou deixe que as skills acima as puxem.

  • /domain-modeling — aprimore a linguagem de domínio do projeto: desafie um termo vago, resolva uma palavra sobrecarregada ("conta" fazendo três trabalhos), registre uma decisão difícil de reverter como um ADR. É a disciplina ativa que /grill-with-docs impulsiona para manter CONTEXT.md como um glossário limpo.
  • /codebase-design — o vocabulário de módulo profundo (módulo, interface, profundidade, junção, adaptador, alavancagem, localidade) para projetar a forma de um módulo: muito comportamento por trás de uma interface pequena em uma junção limpa. /tdd e /improve-codebase-architecture ambos falam essa linguagem.

Cruzando sessões

  • /handoff — quando um tópico está cheio ou você precisa ramificar (por exemplo, em uma sessão /prototype), isso compacta a conversa em um arquivo markdown. Você não continua no lugar — você abre uma nova sessão e referencia aquele arquivo para carregar o contexto adiante. É a ponte entre janelas de contexto, em ambas as direções. Use-o quando quiser uma sessão nova mas precisar da conversa atual preservada.
  • /compact (embutido) — permaneça na mesma conversa, permitindo que as trocas anteriores sejam resumidas. Use-o em pausas intencionais entre fases, quando não se importar em perder o histórico verbatim. Não compacte no meio de uma fase — o agente pode perder o rumo. /handoff bifurca; /compact continua.

Independentes

Fora do fluxo principal completamente.

  • /grill-me — a mesma entrevista implacável que /grill-with-docs, mas para quando você não tem codebase. Sem estado: não salva nada localmente, não constrói CONTEXT.md. Recorra a ela para aprimorar qualquer plano ou design que não viva em um repositório.
  • /prototype — um programa pequeno e descartável que responde a uma pergunta de design: esse modelo de estado parece certo, ou qual deveria ser a aparência desta UI. Descartável desde o primeiro dia — guarde a resposta, delete o código. É o desvio no passo 2 do fluxo principal, mas recorra a ele sempre que uma pergunta de design for difícil de resolver no papel.
  • /research — delegue o trabalho de leitura a um agente em segundo plano: ele investiga uma pergunta contra fontes primárias e depois deixa um arquivo Markdown citado no repositório. Continue trabalhando enquanto ele lê. O arquivo que ele produz é algo para levar para o fluxo principal em /grill-with-docs — a pesquisa alimenta o pensamento, não o substitui.
  • /teach — aprenda um conceito ao longo de múltiplas sessões, usando o diretório atual como um workspace com estado.
  • /writing-great-skills — referência para escrever e editar skills bem.

Pré-condição

/setup-matt-pocock-skills — execute antes do seu primeiro fluxo de engenharia para configurar o rastreador de issues, os rótulos de triagem e o layout de documentos que as outras skills assumem. Rastreadores de issues personalizados também funcionam.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

Habilidades Relacionadas