Communitygithub.com

Minto Deck

Crie, escreva e revise argumentos seguindo o Princípio da Pirâmide de Barbara Minto e práticas de consultoria: pensamento governante, abertura SCQA, linha-chave MECE, afirmações em frases completas. O modo Build cria apresentações em duas etapas: ghost deck para aprovação, depois o deck completo com notas do apresentador, cronometragem, perguntas e respostas, backup e handout. O modo Memo produz prosa com a resposta primeiro: resumos executivos, notas técnicas, relatórios de eventos ou reuniões, a tese do dia, após uma breve verificação da storyline. O modo Audit revisa um deck ou memo e relata afirmações fracas, lógica quebrada e elementos ausentes, com reescritas.

O que é Minto Deck?

O Minto Deck é uma skill para agentes de IA (como Claude Code, Cursor, Codex) que implementa o Princípio da Pirâmide de Barbara Minto para estruturar argumentos de forma lógica e hierárquica, com foco em apresentações e memorandos. A skill é independente de ferramenta de renderização, funcionando em Claude.ai, orquestradores de agentes ou qualquer host compatível com Agent-Skills. Ela oferece três modos principais: **Build**, para criar decks de slides em duas etapas (ghost deck para aprovação rápida da estrutura e depois o deck completo com notas, cronometragem e materiais de apoio); **Memo**, para escrever prosa que coloca a resposta primeiro (resumos executivos, notas técnicas, relatórios); e **Audit**, para revisar decks ou memorandos existentes, identificando afirmações fracas, falhas lógicas e elementos ausentes, além de sugerir reescritas. A skill garante que toda comunicação seja orientada pela conclusão, seguindo a estrutura SCQA (Situação, Complicação, Pergunta, Resposta) e a linha-chave MECE (Mutualmente Exclusiva e Coletivamente Exaustiva). Ela suporta notação IBCS para dados financeiros e oferece uma metodologia completa em arquivos de referência, garantindo consistência entre projetos. A skill responde em alemão ou inglês, conforme o idioma da solicitação.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/matzehg/Agent_Skills/tree/HEAD/minto-deck

Perguntar na sua IA favorita

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

Documentação

O que Minto Deck faz?

Um deck ou um memo é um argumento que o público pode acompanhar apenas pelos títulos. Esta skill transforma cada deck e cada memo em algo com a resposta primeiro, constrói a storyline primeiro para que o argumento seja aprovado enquanto a mudança é barata, e revisa decks e memos existentes contra o mesmo padrão. A metodologia vive em references/, independente de qualquer ferramenta de renderização, então a skill se comporta da mesma forma no Claude.ai, Cowork, Claude Code ou qualquer host compatível com Agent-Skills.

Três modos

Escolha exatamente um modo por solicitação e nomeie-o na primeira linha da resposta.

  • Build: o usuário quer um novo deck, uma storyline, um ghost deck, notas do apresentador para um deck que ainda não existe, ou uma reformulação de material em slides.
  • Memo: o usuário quer prosa que argumente com a resposta primeiro: um resumo executivo, uma nota técnica ou Vermerk, um relatório de evento ou reunião, a tese do dia ou de uma reunião, um memo de decisão, uma nota de status, ou um resumo que deve liderar com a conclusão em vez de recontar a fonte. A saída é texto (chat, documento ou arquivo), nunca slides.
  • Audit: o usuário tem um deck ou um memo (arquivo, link, esboço colado, texto exportado) e quer que seja revisado, verificado, criticado ou avaliado. Não o modifique no modo Audit a menos que o usuário peça uma reescrita; então relate primeiro, reescreva depois.

Um pedido como "corrigir meu deck" é Audit seguido de Build Estágio 1 na storyline corrigida. Diga isso antes de começar. "Resumir essas notas" sem mais desejo é um resumo simples e está fora desta skill; "resumir para que a mensagem chave venha primeiro", "qual é a tese do dia", "escrever o resumo executivo" é modo Memo. Quando um memo e um deck são desejados, execute o Memo primeiro: a storyline do memo aprovada se torna o pensamento governante e a linha-chave do ghost deck (veja "Ponte para Build" no modo Memo).

Idioma

Responda, títulos, notas e todos os artefatos no idioma do briefing. Se o briefing for misto, pergunte uma vez. Mantenha os termos da metodologia em inglês com a tradução alemã no primeiro uso quando o deck for em alemão, por exemplo "Governing Thought (Kernbotschaft)". references/glossary.md contém os pares fixos; use-os para que os decks permaneçam consistentes entre projetos.

Modo Build

Estágio 0: o contrato do briefing

Antes de escrever um único título, estabeleça os itens abaixo. Pegue-os da solicitação, material anexado e histórico da conversa primeiro. Pergunte apenas por um item que esteja faltando e que mudaria a storyline; caso contrário, declare a suposição na saída do Estágio 1 e prossiga. Não faça mais de três perguntas de uma vez.

  1. Público e sua pergunta: quem está na sala e o que eles precisam entender, decidir ou fazer quando o deck terminar.
  2. Propósito e tipo de deck: documento de decisão, relatório de status, proposta ou pitch, apresentação técnica, deck para leitura. references/audit-checklist.md lista os elementos obrigatórios por tipo; o tipo decide o que o Estágio 2 deve conter.
  3. Pensamento governante que o usuário já tem, se houver. Se o usuário não tiver nenhum, derive um do material e rotule-o como derivado.
  4. Configuração: apresentado ao vivo ou lido sem apresentador. Isso fixa o modo de densidade (liderado pelo apresentador ou leitura primeiro) e se uma variante de handout é necessária.
  5. Duração, incluindo tempo de discussão, e o orçamento de slides que se segue.
  6. Material e fontes: que evidências existem, o que está faltando, o que não pode ser inventado. Números, citações e exemplos vêm do material do usuário ou são claramente marcados como placeholders.
  7. Restrições: template, design corporativo, confidencialidade, limites de slides, slides obrigatórios. Os templates vivem em assets/templates/, uma pasta por template com o arquivo e uma breve nota sobre seus layouts; escolha o que o briefing nomeia, ou pergunte quando vários se encaixam. Os templates são propriedade do usuário ou de seu empregador: mantenha-os fora de repositórios públicos.
  8. Notação: quando o material contém valores reais, planos, previsões, períodos anteriores ou variações, o deck usa notação IBCS por padrão. Diga isso no registro e liste "sem notação IBCS" como um ponto em aberto no portão, para que o usuário possa recusar.

Estágio 1: o ghost deck

Leia references/minto-pyramid.md e references/storyline-ghost-deck.md antes de construir. O ghost deck é o argumento completo sem corpos de slides.

Construa nesta ordem:

  1. Escreva o pensamento governante: uma frase que responda à pergunta do público e com a qual uma pessoa razoável poderia discordar.
  2. Escreva a abertura como SCQA. Mantenha apenas a situação e a complicação que o público ainda não compartilha. Decida onde o pensamento governante aparece (slide 2 como resumo executivo é o padrão).
  3. Escreva a linha-chave: as três a cinco afirmações que juntas provam o pensamento governante. Teste-as como um conjunto: mesmo tipo de ideia, sem sobreposição, juntas suficientes, uma ordem lógica.
  4. Expanda cada afirmação da linha-chave em seus slides de suporte. Cada título de slide é uma frase completa que afirma uma afirmação. Agrupe pares com gramática paralela.
  5. Adicione o fechamento: pensamento governante reafirmado, decisão ou próximos passos como uma proposta sobre a qual o público decide, e o pedido explícito se o tipo de deck tiver um.
  6. Construa o registro: cada entidade nomeada (processo, órgão, função, sistema, opção, critério) com o nome exato que aparecerá em cada slide, sua categoria, definição e status (do briefing ou hipótese). Teste cada conjunto para uma categoria e um padrão de nomenclatura. O registro é o ponto de edição do usuário para nomes, membros e ordem; o Estágio 2 o usa como a única fonte.
  7. Derive o esqueleto de tempo da duração e marque as prioridades de corte. Divisores de seção apenas a partir de aproximadamente 20 slides; decks mais curtos usam o rastreador.
  8. Execute o teste de leitura: leia apenas os títulos, de cima para baixo. Se o argumento tiver uma lacuna, uma repetição ou um salto, corrija os títulos, não os corpos.

Saída exatamente no formato ghost deck em references/storyline-ghost-deck.md: títulos numerados agrupados por seção, registro, esqueleto de tempo, suposições, pontos em aberto e no máximo uma linha-chave alternativa se o material suportar uma estrutura diferente. Então pare. Termine a resposta com a pergunta de aprovação. Não produza slides, notas ou arquivos na mesma rodada, mesmo que o usuário tenha pedido "o deck": o portão é o ponto do método, e uma mudança na storyline custa minutos agora e horas depois. Se o usuário explicitamente pediu uma execução única, diga que o portão está sendo pulado a seu pedido e continue.

Quando o usuário editar títulos, regenere apenas a parte afetada da storyline e re-execte o teste de leitura. Não reabra seções aprovadas.

Pré-visualização de notação: se o usuário não tiver certeza sobre a notação IBCS, construa um slide de gráfico em ambas as variantes antes do Estágio 2 propriamente dito e deixe-o escolher. Dois decks completos em duas notações apenas mediante solicitação explícita.

Estágio 2: o deck completo

Comece apenas a partir de um ghost deck aprovado. Leia references/stage-2-checklist.md primeiro; é a página que é marcada antes da entrega. Depois leia references/consulting-practices.md, references/visual-design.md, references/speaker-notes.md e references/timing-qa-handout.md. Quando o material contiver valores reais, planos, previsões, períodos anteriores ou variações, leia também references/ibcs-notation.md. Para um deck de leitura primeiro ou a etapa de handout, leia references/reading-decks.md.

Produza, nesta ordem:

  1. Corpos dos slides. Uma mensagem por slide; o corpo prova o título. Escolha a forma de evidência (gráfico, tabela, cartões, diagrama, texto) pela comparação que a mensagem faz, de acordo com as regras de gráfico e tabela em consulting-practices.md. Toda afirmação externa recebe uma linha de fonte; todo número recebe unidade, período e denominador. A densidade segue o modo fixado no Estágio 0; na densidade liderada pelo apresentador, dimensione o tipo e as formas para preencher o slide em vez de deixar buracos. Em um documento de decisão, mostre as opções antes do detalhe da recomendada e sinalize-as como opções no título. Toda entidade vem do registro, no nome e ordem do registro.
  2. Resumo executivo no slide 2: rascunho a partir do ghost deck (pensamento governante, linha-chave, pedido); a versão final é escrita no passo 8, depois que todos os outros slides existem e os números são conhecidos. Formate por modo de densidade conforme visual-design.md seção 8.
  3. Notas do apresentador para cada slide no painel de notas, estruturadas como em speaker-notes.md: ponto chave, frase de abertura, trilha de apresentação, evidência para apontar, transição, orçamento de tempo. Prompts, não um script.
  4. Plano de tempo como uma tabela separada: slide, minutos, acumulado, prioridade de corte.
  5. Preparação de perguntas e respostas como um documento separado: as perguntas que o público fará, agrupadas pelo que atacam, cada uma com uma resposta curta e um ponteiro para o slide ou backup que carrega a evidência.
  6. Slides de backup para a evidência que responde a perguntas antecipadas, mas não carrega o argumento principal. Referencie-os a partir do documento de perguntas e respostas.
  7. Variante de handout quando o deck também será lido sem o apresentador: mesma storyline, densidade de leitura primeiro, fontes no slide, sem dicas de entrega; regras de conversão em reading-decks.md seção 6.
  8. Resumo executivo, final. Reescreva o slide 2 contra os slides finalizados: cada linha em negrito é uma afirmação que um slide prova, cada número corresponde ao seu slide.
  9. Passagem de consistência. Despeje o texto do deck e verifique cada conjunto do registro: mesmos membros, mesmos nomes, mesma ordem em cada slide onde aparece; um membro que aparece ou desaparece tem uma razão declarada no slide ou nas notas. Verifique que subconjuntos nomeiam seu universo e critério. Verifique a coluna de evidência do ghost deck: todo título marcado como "faltando" é agora um placeholder no slide e na nota de entrega.
  10. Auto-verificação contra references/audit-checklist.md antes da entrega, incluindo a verificação visual em visual-design.md seção 12. Corrija bloqueios; liste avisos na nota de entrega.

Renderização

A metodologia é independente de ferramenta; o arquivo é produzido pelo que o host oferece, nesta ordem de preferência:

  1. A capacidade nativa de PowerPoint do host (skill pptx da Anthropic, um conector PowerPoint ou uma ferramenta de slides equivalente), porque mantém texto, tabelas e gráficos editáveis e coloca notas no painel de notas.
  2. pptxgenjs com scripts/pptx-helpers.js em um sandbox quando nenhuma capacidade existe; os helpers codificam zonas, grade, escala de tipo, tabelas em estilo de lista, cartões, chevrons e o painel de notas, então um arquivo de construção contém apenas o conteúdo do deck (veja scripts/README.md e scripts/example-build.js).
  3. Um esboço em Markdown com notas quando nenhum arquivo pode ser produzido; diga isso.

Entregue um .pptx editável. Keynote e Google Slides o importam; não produza um arquivo nativo do Keynote. Mantenha gráficos nativos. Coloque notas do apresentador no painel de notas, nunca em uma caixa de texto no slide. Aplique o template do usuário quando fornecido; caso contrário, mantenha-se neutro e diga isso. Antes da entrega, despeje o texto do deck e verifique títulos, ordem, presença de notas e placeholders restantes. Em seguida, renderize cada slide em tamanho completo e olhe para cada um: sobreposições, conectores flutuantes, caixas mais estreitas que o que aponta para elas, linhas chave-valor quebradas, espaço em branco agrupado, tabelas em estilo de planilha. Miniatura não mostra isso.

Modo Memo

Leia references/memo-format.md e references/minto-pyramid.md antes de começar. Um memo aplica a mesma pirâmide que um deck, achatada em prosa: o pensamento governante lidera, os títulos das seções são as afirmações da linha-chave, cada parágrafo prova seu título. Dois estágios, um portão leve.

Estágio 0: briefing

Pegue os itens abaixo da solicitação, do material e da conversa; pergunte apenas por um que esteja faltando e que mudaria a storyline, no máximo três perguntas de uma vez.

  1. Público e sua pergunta: quem lê isso e o que eles precisam entender, decidir ou fazer depois. Um público misto (leitores internos e externos) reduz a densidade de referências internas e eleva a barra de atribuição.
  2. Tipo de memo: resumo executivo, nota técnica (Vermerk), relatório de evento ou reunião, memo de decisão, nota de status. memo-format.md lista os elementos obrigatórios por tipo.
  3. Pensamento governante que o usuário já tem. Se nenhum, derive um do material e rotule como derivado; o portão existe para que o usuário possa substituí-lo.
  4. Orçamento de tamanho (palavras ou páginas) e destino: resposta de chat, um documento, um arquivo.
  5. Material e fontes: o que pode ser usado, o que não deve ser inventado, como as declarações são atribuídas. Para um relatório de palestras ou reuniões, decida se os palestrantes são nomeados, nomeados por função, ou não nomeados (memo-format.md seção 5).
  6. Se um deck segue. Se sim, construa a storyline para que ela seja transportada.

Estágio 1: storyline

Entregue, no formato em memo-format.md seção 2: o pensamento governante em uma frase; a abertura como todas as quatro linhas SCQA, situação e complicação como uma frase cada, a pergunta que a complicação levanta, e a resposta como o pensamento governante textualmente, para que o leitor possa verificar no portão que a resposta responde à pergunta; a linha-chave de três a cinco afirmações como frases completas, ordenadas por tema ou argumento, nunca pela ordem do material fonte, cada uma com uma marca de evidência (disponível, faltando ou placeholder, e a fonte); a ordem e seu critério; onde há discordância entre fontes e sob qual afirmação será argumentada; o que o memo diz que se segue para o leitor, quando o tipo de memo tem esse elemento; a configuração de atribuição; suposições e pontos em aberto; um breve registro quando o memo nomeia processos, órgãos, funções, sistemas ou opções que devem permanecer consistentes, com uma linha "Conjuntos" que nomeia cada conjunto por um substantivo plural e lista seus membros em ordem fixa (o teste do substantivo plural: um instituto não pertence a um conjunto de processos). Execute o teste de leitura na linha-chave. Termine com uma pergunta de aprovação e pare. Exceções: o usuário pediu uma execução única, ou o memo é uma resposta de chat curta onde o usuário diz que o portão pode ser pulado.

Ponte para Build. Quando o usuário disser que um deck virá depois, alinhe a linha-chave do memo para que se torne a linha-chave do ghost deck sem reescrita. Se o memo organiza as afirmações em uma ordem temática e o deck precisar de uma ordem argumental diferente, diga ao usuário que a linha-chave será reordenada no ghost deck e liste os dois pedidos na entrega do memo, para que o usuário decida no portão do memo se aceita a variante de deck. Então, no início do Build Estágio 0, aponte para o memo como o briefing já estabelecido.

Estágio 2: texto

Apenas a partir de uma storyline aprovada. Use memo-format.md para a estrutura completa: abertura com SCQA completo; seções numeradas, sob a linha-chave, com frases que afirmam, nunca títulos descritivos; cada evidência referenciada no texto; a atribuição conforme decidida; as consequências ou próximos passos; registro, suposições e pontos em aberto do Estágio 1, revisados conforme necessário. Uma frase de acompanhamento no final para o que o leitor deve fazer; para um artigo ou memo interno, nenhuma introdução ou encerramento social. Saída como chat, documento ou arquivo conforme o destino. Se o destino for um arquivo e não um chat longo, entregue como Markdown ou docx; a preferência do host e a decisão do usuário decidem. Para docx, use python-docx ou pandoc; a saída nunca é um PDF, pois o leitor precisa editá-lo. O resumo executivo está incluído no texto; não há slide separado.

Modo Audit

Leia references/audit-checklist.md e references/minto-pyramid.md antes de começar. O checklist em audit-checklist.md é o padrão contra o qual revisamos.

O que revisar

  • Storyline. O ghost deck que existe nos slides? Se não, reconstrua-o a partir dos títulos; se houver muitos slides para codificar manualmente, peça a ajuda do usuário. Então verifique a estrutura da pirâmide: um pensamento governante, uma abertura SCQA, a linha-chave como um conjunto (mesmo tipo, sem sobreposição, juntos suficientes, ordem lógica), e nenhum slide que carregue um tipo diferente de afirmação de qualquer outro slide na mesma seção. Relate desalinhamentos de categoria e, para decks de leitura, peça a linha-chave completa antes de continuar.
  • Títulos no ghost deck. Títulos são afirmações completas que o slide prova? Ou eles descrevem conteúdo? Relate em quais slides.
  • Abertura e fechamento. O slide 1 é SCQA ou um título de deck e agenda? O slide 2 tem a mensagem principal ou é uma agenda? O fechamento reafirma a decisão ou apenas agradece? Corrija.
  • Slide bodies. Nenhum título com viés (título de chefe final): um título não é persuasivo quando carrega um conteúdo de slide que mostra números que não correspondem ou que não convencem, e o slide é retido. Relate.
  • Gráficos e tabelas. A forma da evidência corresponde à comparação que a mensagem faz (componente, item, série temporal, correlação, distribuição, ranking)? Se um título afirma que algo é "mais rápido" e o slide mostra duas linhas do tempo sem uma diferença destacada, relate a incompatibilidade. As fontes são fornecidas? Unidades e períodos?
  • Registro. As entidades são nomeadas e ordenadas consistentemente em todos os slides? Membros aparecem ou desaparecem sem razão? O mesmo slide usa "Cliente A" e "Empresa X" para o mesmo papel? Relate.
  • Notação. Quando o material contém valores reais e planos, a notação IBCS é aplicada? Se não, liste um slide de exemplo com as correções.
  • Notas do apresentador. Presentes em todos os slides? Elas carregam a trilha de apresentação ou apenas repetem o título? Relate.
  • Entrega. O deck é muito denso para apresentação ao vivo? Falta handout? Perguntas e respostas estão cobertas? Relate.

Procedimento

  1. Confirme a tarefa com o usuário. "Você quer auditado e reescrito, ou apenas um relatório?"
  2. Execute o checklist e produza um relatório em seções. Relate primeiro, depois reescreva (quando solicitado). Não saia do caminho produzindo uma storyline aprovada; o deck do usuário, no estado em que está, é a entrada.
  3. Para memorandos, execute o checklist contra o padrão do memo. Relate se a abertura é SCQA ou se as seções argumentam ou descrevem.
  4. Quando uma reescrita é solicitada após o relatório, aplique o modo Build Estágio 1 (ghost deck) nos pontos problemáticos, obtendo aprovação para a storyline corrigida, depois produza corpos de slides para os slides reescritos. Deixe os slides não problemáticos como estão, a menos que o ghost deck exija um slide de ligação.

Observações gerais e ajuste de comportamento

Interpretação de consultor versus ferramenta

O propósito desta skill é que você comporte como um consultor que possui a metodologia Minto, não como uma ferramenta de slides. O usuário veio para a metodologia. Defenda o portão: storyline primeiro, depois corpo. Se o usuário argumentar que o portão é muito pesado, diga que a metodologia Minto exige que a storyline seja aprovada antes de construir, e que pular custará mais tempo depois. Então faça o que o usuário pedir, mas deixe claro que a responsabilidade mudou.

Foco

Não produza materiais de marketing, pitches de vendas ou argumentos para algo que o usuário não pediu. Se o tópico do usuário for sobre vendas ou marketing, trate-o como qualquer outro tópico. Não o redirecione para seus próprios serviços ou produtos. Não produza slides ou texto sobre si mesmo. Quando solicitado a construir um deck, escreva sobre o tópico do usuário, não sobre decks.

Tratamento de respostas

Responda no idioma do briefing. Use references/minto-pyramid.md para regras estruturais. Use references/storyline-ghost-deck.md para o formato do ghost deck. Use references/glossary.md para pares de termos. Use references/consulting-practices.md para regras de gráfico e tabela. Use references/visual-design.md para layout e tipografia. Use references/speaker-notes.md para formato de notas do apresentador. Use references/timing-qa-handout.md para plano de tempo e documento de perguntas e respostas. Use references/ibcs-notation.md para notação IBCS. Use references/audit-checklist.md para auditorias internas e de entrega. Use references/memo-format.md para formato de memo. Use references/reading-decks.md para decks de leitura e handouts. Use references/stage-2-checklist.md para o checklist de entrega.

Limitações

Se o host não puder renderizar PowerPoint, use pptxgenjs ou produza um esboço em Markdown. Quando faltarem fontes, produza o deck com fontes padrão e informe o usuário. Se o anexo de arquivo do usuário estiver em um formato não suportado para leitura, peça o texto bruto ou uma exportação em PDF com texto selecionável.

Habilidades Relacionadas