Communitygithub.com

relatório-apresentação

Transforme relatórios técnicos, teses ou projetos em palestras e slides, revise e aprimore slides ou roteiros existentes, e prepare-se para ensaios, apresentações e perguntas — incluindo defesas de tese, apresentações de status e declarações curtas de 3 a 10 minutos. Cria decks em asciidoctor-reveal.js (AsciiDoc) ou LaTeX Beamer com diagramas PlantUML e notas do orador, e os verifica com um script de estatísticas.

O que é relatório-apresentação?

Esta habilidade abrange todo o ciclo de vida da criação e entrega de apresentações técnicas — desde transformar relatórios, teses ou projetos em palestras impactantes, passando pela revisão de slides e roteiros existentes, até a preparação para ensaios, entrega e sessões de perguntas e respostas. Ela oferece metodologia baseada em Hering & Heyne (How to Write Technical and Scientific Reports, 3ª ed.) e suporta a criação de decks em dois formatos principais: asciidoctor-reveal.js (para projetos em AsciiDoc) e LaTeX Beamer (para relatórios em LaTeX ou quando necessário um PDF), com diagramas PlantUML e notas do orador claramente estruturadas. A habilidade enfatiza que uma apresentação é uma criação nova, não o relatório lido em voz alta — seguindo proporções de tempo (20/70/10), regra dos terços para audiência mista, design de slides enxuto com mensagens explícitas nos títulos, e verificação automática via script de estatísticas (deck_stats.py) que avalia palavras, elementos, notas e estima tempo de fala. Além da criação, inclui um processo sistemático de revisão de decks e roteiros, com classificação por gravidade e recomendações concretas. Esta skill é útil para qualquer desenvolvedor ou engenheiro que precise criar apresentações técnicas profissionais — como palestras de conferência, defesas de tese, atualizações de status ou declarações curtas — garantindo que o conteúdo seja relevante, visualmente claro e adequado ao tempo disponível. Suporta os ambientes asciidoctor-reveal.js e LaTeX Beamer, com scripts dedicados para análise e ajuste fino.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/larsw/report-writing-skills/tree/HEAD/skills/report-presentation

Perguntar na sua IA favorita

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

Documentação

Apresentações técnicas

Uma palestra é uma criação nova, não o relatório lido em voz alta. Um relatório alcança a cabeça; uma palestra também alcança o coração. Leitores escolhem seu ritmo e distância (30–40 cm); um ouvinte vê cada slide por segundos, a 10 m de distância, enquanto também escuta. Meses de trabalho não cabem em 20 minutos: a palestra oferece um "espiada pela fechadura" bem escolhida que cada ouvinte pode acompanhar e lembrar.

Método segundo H. Hering (com K.-G. Heyne), How to Write Technical and Scientific Reports (3ª ed., Springer 2025), Cap. 5.

Decida qual é o trabalho:

  • Criar uma palestra/deck a partir de um relatório ou material → seções 1–5
  • Revisar um deck ou roteiro existente → seção 6
  • Ensaio, entrega, perguntas → references/delivery.md
  • Declaração curta (3–10 min, slides muitas vezes improvisados) → references/delivery.md, "Declaração curta"

1. Estrutura e objetivo (escreva primeiro)

Preencha a ficha de planejamento de references/talk-planning.md com o usuário, a partir do que ele lhe deu; pergunte apenas o que altera a palestra:

  • tópico e título da palestra (mais curto e memorável que o título do relatório, ainda preciso)
  • audiência: quem, conhecimento prévio, interesses, expectativas, quem decide
  • ocasião e intervalo de tempo exato sem e com discussão
  • tipo: palestra (informar), apresentação técnica (informar e influenciar), apresentação persuasiva, discurso ocasional
  • objetivos com pesos, ex.: 70% informar sobre resultados, 20% mostrar competência, 10% descontração e humor; e o propósito por trás (nota, financiamento, decisão, projeto de acompanhamento)
  • sala, mídia, configuração remota/híbrida; palestrantes anterior e seguinte
  • confidencialidade: divulgações claras com o supervisor, chefe ou cliente (e marketing em empresas) antes de palestras externas

2. Selecionar material

Mantenha apenas o que é essencial, significativo e representativo para esta audiência e objetivo. Coloque o restante em uma reserva (slides de backup, notas "pode") para tempo livre e perguntas. Elimine toda digressão que interessa principalmente ao autor.

3. Criar a estrutura da palestra

Distancie-se dos capítulos do relatório; assuma a posição da audiência. Construa poucos itens curtos e memoráveis com uma dramaturgia:

  • Abra com algo que crie tensão (uma pergunta, um problema com consequências concretas, um exemplo marcante); feche respondendo-a.
  • Divisão de tempo cerca de 20% introdução / 70% parte principal / 10% conclusão para uma palestra de 20 minutos (4/14/2 min). Para 60 minutos, introdução e conclusão crescem menos que proporcionalmente (8/48/4).
  • Parte principal para audiência mista (regra dos terços), intercalada, não em blocos estritos: exemplos conhecidos e visão geral (≈1/3) → novo insight em nível que a maioria possa acompanhar (≈1/6) → detalhes técnicos (≈1/3), retornando ao nível geral frequentemente → agregação, conclusões, avaliação que todos entendem (≈1/6). Ninguém deve sair pensando "eu já sabia tudo" ou "foi muito complicado".
  • Introdução: contato, objetivo da palestra, percurso (slide de estrutura), demarcação (o que você não cobrirá).
  • Conclusão: os resultados-chave novamente, uma breve perspectiva, nada novo, um final claro.

Registre no diagrama de estrutura (modelo em references/talk-planning.md) com minutos por parte. Um relatório de 135 páginas pode se tornar uma pergunta de abertura, um item principal com três subitens e uma conclusão.

4. Slides

Leia references/slide-design.md antes de escrever slides. O essencial:

  • "Quanto menos, melhor." 5 a 7 elementos por slide; palavras-chave, não frases (o slide final de resumo pode usar frases curtas).
  • Cada título declara a mensagem do slide em linguagem falada ("Sucção integrada remove 90% dos fumos"), e mapeia claramente para o item estrutural atual.
  • Visualize em vez de escrever; redesenhe figuras do relatório para projeção: menos elementos, linhas mais grossas, rótulos muito maiores. Nunca cole uma figura de relatório ou periódico sem alteração.
  • Texto não menor que cerca de 1/30 da altura do slide (≈ 18 pt em um slide clássico); sem serifa; no máximo dois tamanhos de fonte por slide; cor com moderação e sempre com significado; preto sobre branco é o mais legível; texto colorido precisa de 1,5× o tamanho.
  • Sem poluição repetida em cada slide: sem título da palestra, nome, data, contador "Slide x de y", rodapés longos. Um número de slide pequeno é aceitável.
  • Três slides de estrutura: slide de título; slide de estrutura com palavras-chave do conteúdo (não "Introdução / Parte principal / Resumo / Obrigado"); slide final que convida à discussão (imagem-chave, dados de contato). "Obrigado" e "Perguntas?" são ditos, não mostrados.
  • Mantenha a audiência orientada: mostre a estrutura novamente nas transições com o item atual destacado.
  • Animação apenas para construções passo a passo de listas ou processos; nunca movimento decorativo ou som.
  • Marque slides puláveis (reserva) com antecedência.

5. Construir o deck (asciidoctor-reveal.js ou Beamer)

Use o formato com o qual o usuário trabalha: asciidoctor-reveal.js para projetos em AsciiDoc, LaTeX Beamer quando o relatório está em LaTeX ou um deck em PDF é necessário (pergunte se não estiver claro).

  • reveal.js: references/revealjs-asciidoc.md: uma seção == por slide, [.notes] notas do orador em cada slide de conteúdo, [%step] para construções, diagramas PlantUML com fontes do tamanho do slide, um CSS personalizado com a classe highlight para slides de estrutura.
  • Beamer: references/beamer.md: um frame por slide com título de mensagem, \note{…} notas do orador, overlays para construções, \AtBeginSection + \tableofcontents[currentsection] para o slide de estrutura, símbolos de navegação e rodapés repetidos desligados.

Em ambos os formatos, escreva as notas do orador como palavras-chave, não texto completo, marcadas como DEVE / DEVERIA / PODE (o que deve ser dito, o que pode ser cortado quando o tempo é curto, o que é reserva) e com um ponto de verificação "feito em mm:ss" em cada item estrutural.

Em seguida, verifique:

python3 scripts/deck_stats.py deck.adoc --minutes 20      # este diretório da habilidade
python3 scripts/deck_stats.py talk.tex --minutes 20       # Beamer: frames, \frametitle, \note, backup após \appendix

Isso lista por slide as palavras visíveis, elementos e notas, estima o tempo de fala a partir das notas (130 palavras/min por padrão) e sinaliza slides sobrecarregados, frases nos slides, títulos ausentes, slides "Obrigado"/"Perguntas?", itens de agenda genéricos e slides sem notas. Ajuste até que o tempo planejado esteja abaixo do intervalo (palestras ao vivo duram mais do que as notas sugerem) e cada sinalização seja corrigida ou uma escolha deliberada (um slide técnico curto e denso pode ser intencional).

Entregue: o arquivo do deck (e CSS personalizado), a ficha de planejamento e o diagrama de estrutura, a tabela de tempos e uma lista de slides de reserva. Recomende um ensaio completo e cronometrado com um ouvinte (veja references/delivery.md).

6. Revisar um deck ou roteiro existente

  1. Obtenha a estrutura: audiência, intervalo, objetivo. Sem isso, feedback de slides é achismo.
  2. Execute deck_stats.py (decks em AsciiDoc ou Beamer) ou extraia o texto dos slides (.pptx/PDF) e conte as mesmas coisas lendo.
  3. Verifique a palestra como um todo: é uma criação nova ou o sumário do relatório nos slides? Tensão de abertura e pergunta respondida? Divisão de tempo 20/70/10? Mistura da regra dos terços (muito superficial para especialistas ou muito jargão para o resto)? Teoria primeiro e exemplos depois (falha frequente)? Resumos intermediários? Material de reserva? Final claro?
  4. Verifique cada slide de acordo com references/slide-design.md.
  5. Relate por gravidade (crítico: não cabe no intervalo, nível errado da audiência, sem mensagem; maior: slides sobrecarregados ou ilegíveis, figuras do relatório sem alteração, orientação estrutural ausente; menor: detalhes de estilo). Para cada achado em um slide, dê o número/título do slide e uma reescrita concreta (novo título, lista cortada, descrição de figura redesenhada). Para uma avaliação no estilo de pontuação de uma palestra já apresentada, use o formulário de revisão em references/delivery.md.

Individual skills in this repo

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

report-copyedit

Copyedit and line-edit technical and scientific writing (reports, theses, lab reports, papers, specifications, design docs, technical documentation) for clarity, precision, consistent terminology and correct notation, without changing the technical content. Use this whenever someone asks to copyedit, proofread, line-edit, tighten, simplify, polish the language of, improve the readability or flow of, or "fix the English in" a technical text, AsciiDoc, LaTeX or Markdown file; to make terms, units, abbreviations, hyphenation or capitalization consistent; or to build a style sheet from an existing draft. For a whole-document pre-submission review (structure, figures, references, checklist) use report-review instead.

report-drafting

Draft the content of technical and scientific reports - introduction, state of the art, methods/test setup, results, discussion, summary/conclusions, abstract, appendices - together with their figures, tables, PlantUML diagrams, charts, formulas, computations and citations, in AsciiDoc, LaTeX or plain prose. Use this whenever someone asks to write, draft, expand, or turn notes, data, measurements, code or bullet points into a section of a report, thesis, lab report, design report, project report or technical documentation; to create or improve a figure, diagram, chart, caption, table or evaluation/decision matrix for one; to set up equations or a load calculation; or to add citations and a reference list - even if they just say "write up these results".

report-outline

Plan a technical or scientific report before and while drafting it - analyze the assignment, write and test title variants, condense the core message into one sentence, grow a 4-point then 10-point then detailed outline, pick a structure pattern for the report type (lab/test report, design report, project report, thesis, manual, research paper), and set up a style sheet and an AsciiDoc or LaTeX skeleton. Use this whenever someone is starting or reorganizing a report, thesis, lab report, design report, project report or technical documentation and asks for an outline, structure, table of contents, chapter plan, section order, working title or title ideas, or asks "how should I organize this?" - and also to check an existing outline or ToC for logic (lone subsections, unequal siblings, vague headings).

report-review

Review a technical or scientific report, thesis, lab report, design report or technical document as a whole before submission or release - structure and logic, completeness, clarity for a reader without project knowledge, figures and tables, citations and reference list, formulas and notation, terminology consistency, cross-references, open TODO markers and output quality - using a mechanical AsciiDoc/LaTeX linter plus a checklist, and produce a prioritized findings report with concrete fixes. Use this whenever someone asks to review, check, audit, assess, give feedback on, "look over", or do a final/pre-submission/QA pass on a report or thesis (AsciiDoc, LaTeX, Markdown, PDF or Word), asks "is this ready to hand in?", or wants supervisor-style feedback on a draft chapter.

Habilidades Relacionadas