Communitygithub.com

Presentación de informes

Convierte un informe técnico, tesis o proyecto en una charla y presentación de diapositivas, revisa y pule diapositivas existentes o un guion de charla, y prepara ensayos, presentación y preguntas y respuestas, incluyendo defensas de tesis, charlas de estado de proyecto, conferencias y declaraciones breves de 3 a 10 minutos. Genera presentaciones en asciidoctor-reveal.js (AsciiDoc) o LaTeX Beamer con diagramas PlantUML y notas del orador, y las verifica con un script de estadísticas de presentación. Úsalo siempre que alguien pida hacer diapositivas, una presentación o una charla a partir de un informe o resultados, para revisar, criticar o mejorar diapositivas o notas del orador, para ajustar una charla a N minutos, para planificar una defensa o una actualización de estado, o para prepararse para preguntas después de una charla.

¿Qué es Presentación de informes?

Esta habilidad transforma informes técnicos, tesis o proyectos en presentaciones efectivas para conferencias, defensas, actualizaciones de estado o declaraciones breves (3-10 minutos). Sigue el método de Hering y Heyne ('Cómo escribir informes técnicos y científicos'), enfocándose en crear una charla autónoma que cautive a la audiencia, no un resumen del informe. Permite crear presentaciones desde cero, revisar y mejorar diapositivas existentes, y preparar ensayos y la sesión de preguntas y respuestas. Genera presentaciones en formatos asciidoctor-reveal.js (AsciiDoc) o LaTeX Beamer, incluyendo diagramas PlantUML y notas del orador etiquetadas como OBLIGATORIO / DEBERÍA / PUEDE. Incluye un script de estadísticas (deck_stats.py) que analiza diapositivas, calcula el tiempo estimado de habla y señala problemas comunes como diapositivas sobrecargadas, sin título o notas faltantes. La habilidad guía paso a paso: definir el marco y objetivo, seleccionar material esencial, estructurar la charla con una dramaturgia (apertura con tensión, desarrollo con la regla de los tercios, conclusión clara), diseñar diapositivas minimalistas (menos es más, cada título es un mensaje) y construir el mazo en el formato adecuado.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Presentaciones técnicas

Una charla es una creación nueva, no la lectura en voz alta del informe. Un informe llega a la cabeza; una charla también llega al estómago. Los lectores eligen su ritmo y distancia (30–40 cm); un oyente ve cada diapositiva durante segundos, desde 10 m de distancia, mientras también escucha. Meses de trabajo no caben en 20 minutos: la charla ofrece un "vistazo por el ojo de la cerradura" bien elegido que cada oyente puede seguir y recordar.

Método según H. Hering (con K.-G. Heyne), Cómo escribir informes técnicos y científicos (3.ª ed., Springer 2025), cap. 5.

Decida qué trabajo es este:

  • Crear una charla/presentación a partir de un informe o material → secciones 1–5
  • Revisar una presentación o guion existente → sección 6
  • Ensayar, presentar, responder preguntas → references/delivery.md
  • Declaración breve (3–10 min, diapositivas a menudo improvisadas) → references/delivery.md, "Declaración breve"

1. Marco y objetivo (escríbalo primero)

Complete la hoja de marco de references/talk-planning.md con el usuario, a partir de lo que le haya proporcionado; pregunte solo por lo que cambie la charla:

  • tema y título de la charla (más corto y memorable que el título del informe, pero preciso)
  • audiencia: quién, conocimientos previos, intereses, expectativas, quién decide
  • ocasión y franja horaria exacta sin y con discusión
  • tipo: conferencia (informar), presentación técnica (informar e influir), presentación persuasiva, discurso ocasional
  • objetivos con ponderaciones, p. ej., 70 % informar sobre resultados, 20 % mostrar competencia, 10 % soltura y humor; y el propósito detrás de ellos (calificación, financiación, decisión, proyecto de seguimiento)
  • sala, medios, configuración remota/híbrida; oradores anterior y siguiente
  • confidencialidad: divulgaciones claras con el supervisor, jefe o cliente (y marketing en empresas) antes de charlas externas

2. Seleccionar material

Conserve solo lo esencial, significativo y representativo para esta audiencia y objetivo. Ponga el resto en una reserva (diapositivas de respaldo, notas "puede") para tiempo libre y preguntas. Elimine toda digresión que sea interesante principalmente para el autor.

3. Crear la estructura de la charla

Distánciese de los capítulos del informe; tome la posición de la audiencia. Construya algunos elementos cortos y memorables con una dramaturgia:

  • Abra con algo que cree tensión (una pregunta, un problema con consecuencias concretas, un ejemplo impactante); ciérrelo respondiéndolo.
  • Divida el tiempo aproximadamente 20 % introducción / 70 % parte principal / 10 % conclusión para una charla de 20 minutos (4/14/2 min). Para 60 minutos, la introducción y la conclusión crecen menos que proporcionalmente (8/48/4).
  • Parte principal para una audiencia mixta (regla de los tercios), entremezclada, no en bloques estrictos: ejemplos conocidos y visión general (≈1/3) → nueva percepción a un nivel que la mayoría pueda seguir (≈1/6) → detalles de experto (≈1/3), volviendo al nivel general a menudo → agregación, conclusiones, evaluación que todos entienden (≈1/6). Nadie debería irse pensando "ya sabía todo eso" o "fue demasiado complicado".
  • Introducción: contacto, objetivo de la charla, curso (diapositiva de estructura), delimitación (lo que no cubrirá).
  • Conclusión: los resultados clave nuevamente, una breve perspectiva, nada nuevo, un final claro.

Regístrelo en el diagrama de diseño de estructura (plantilla en references/talk-planning.md) con minutos por parte. Un informe de 135 páginas puede convertirse en una pregunta inicial, un elemento principal con tres subelementos y una conclusión.

4. Diapositivas

Lea references/slide-design.md antes de escribir diapositivas. Lo esencial:

  • "Cuanto menos, mejor." 5–7 elementos por diapositiva; palabras clave, no oraciones (la diapositiva de resumen final puede usar declaraciones cortas).
  • Cada título expresa el mensaje de la diapositiva en lenguaje hablado ("La succión integrada elimina el 90 % de los humos"), y se asigna claramente al elemento de estructura actual.
  • Visualice en lugar de escribir; rediseñe las figuras del informe para proyección: menos elementos, líneas más gruesas, etiquetas mucho más grandes. Nunca pegue una figura de informe o revista sin cambios.
  • Texto no más pequeño que aproximadamente 1/30 de la altura de la diapositiva (≈ 18 pt en una diapositiva clásica); sans-serif; como máximo dos tamaños de fuente por diapositiva; color con moderación y siempre con un significado; negro sobre blanco es lo más legible; el texto coloreado necesita 1,5 veces el tamaño.
  • Sin elementos repetidos en cada diapositiva: sin título de charla, nombre, fecha, contador "Diapositiva x de y", pies de página largos. Un número de diapositiva pequeño está bien.
  • Tres diapositivas de marco: diapositiva de título; diapositiva de estructura con palabras clave de contenido (no "Introducción / Parte principal / Resumen / Gracias"); diapositiva final que invite a la discusión (imagen clave, datos de contacto). "Gracias" y "¿Preguntas?" se dicen, no se muestran.
  • Mantenga orientada a la audiencia: muestre la estructura nuevamente en las transiciones con el elemento actual resaltado.
  • Animación solo para construcciones paso a paso de listas o procesos; nunca movimiento decorativo ni sonido.
  • Marque las diapositivas omitibles (reserva) de antemano.

5. Construir la presentación (asciidoctor-reveal.js o Beamer)

Use el formato en el que trabaja el usuario: asciidoctor-reveal.js para proyectos AsciiDoc, LaTeX Beamer cuando el informe está en LaTeX o se requiere una presentación en PDF (pregunte si no está claro).

  • reveal.js: references/revealjs-asciidoc.md: una sección == por diapositiva, notas del orador [.notes] en cada diapositiva de contenido, [%step] para construcciones, diagramas PlantUML con fuentes del tamaño de la diapositiva, un CSS personalizado con la clase de resaltado para diapositivas de estructura.
  • Beamer: references/beamer.md: un frame por diapositiva con un título de mensaje, notas del orador \note{…}, superposiciones para construcciones, \AtBeginSection + \tableofcontents[currentsection] para la diapositiva de estructura, símbolos de navegación y líneas de pie repetidas desactivados.

En ambos formatos, escriba las notas del orador como palabras clave, no texto completo, etiquetadas como OBLIGATORIO / DEBERÍA / PUEDE (lo que debe decirse, lo que se puede omitir si falta tiempo, lo que es reserva) y con un punto de control "hecho a las mm:ss" en cada elemento de estructura.

Luego verifíquelo:

python3 scripts/deck_stats.py deck.adoc --minutes 20      # directorio de esta habilidad
python3 scripts/deck_stats.py talk.tex --minutes 20       # Beamer: frames, \frametitle, \note, backup después de \appendix

Enumera por diapositiva las palabras visibles, elementos y notas, estima el tiempo de habla a partir de las notas (130 palabras/min por defecto) y señala diapositivas sobrecargadas, oraciones en diapositivas, títulos faltantes, diapositivas "Gracias"/"¿Preguntas?", elementos de agenda genéricos y diapositivas sin notas. Ajuste hasta que el tiempo planificado esté por debajo de la franja horaria (las charlas en vivo duran más de lo que sugieren las notas) y cada señal esté corregida o sea una elección deliberada (una diapositiva corta y densa para expertos puede ser intencional).

Entregue: el archivo de la presentación (y CSS personalizado), la hoja de marco y el diagrama de diseño de estructura, la tabla de tiempos y una lista de diapositivas de reserva. Recomiende una prueba completa y cronometrada con un oyente (consulte references/delivery.md).

6. Revisar una presentación o guion existente

  1. Obtenga el marco: audiencia, franja horaria, objetivo. Sin ello, la retroalimentación sobre las diapositivas es una suposición.
  2. Ejecute deck_stats.py (presentaciones AsciiDoc o Beamer) o extraiga el texto de la diapositiva (.pptx/PDF) y cuente las mismas cosas leyendo.
  3. Verifique la charla en su conjunto: ¿es una creación nueva o el índice del informe en diapositivas? ¿Tensión inicial y pregunta respondida? ¿División del tiempo 20/70/10? ¿Mezcla de la regla de los tercios (demasiado superficial para expertos o demasiada jerga para el resto)? ¿Teoría primero y ejemplos después (un defecto frecuente)? ¿Resúmenes intermedios? ¿Material de reserva? ¿Final claro?
  4. Verifique cada diapositiva según references/slide-design.md.
  5. Informe por gravedad (crítico: no se ajusta a la franja horaria, nivel de audiencia incorrecto, sin mensaje; mayor: diapositivas sobrecargadas o ilegibles, figuras del informe sin cambios, falta de orientación de estructura; menor: detalles de estilo). Para cada hallazgo de diapositiva, dé el número/título de la diapositiva y una reescritura concreta (nuevo titular, lista recortada, descripción de figura rediseñada). Para una evaluación tipo puntuación de una charla impartida, use el formulario de revisión en 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.

Skills relacionados