Communitygithub.com

présentation-rapport

Transformez un rapport technique, une thèse ou un projet en présentation et diaporama, révisez et peaufinez des diapositives ou un script de présentation, et préparez la répétition, la prestation et les questions-réponses — y compris les soutenances de thèse, les présentations d'état d'avancement, les conférences et les interventions courtes de 3 à 10 minutes. Générez des diaporamas en asciidoctor-reveal.js (AsciiDoc) ou LaTeX Beamer avec des diagrammes PlantUML et des notes de l'orateur, et vérifiez-les avec un script de statistiques du diaporama. Utilisez ceci dès que quelqu'un demande de créer des diapositives, un diaporama, une présentation ou un exposé à partir d'un rapport ou de résultats, de réviser, critiquer ou améliorer des diapositives ou des notes de l'orateur, d'adapter un exposé à N minutes, de planifier une soutenance ou un point d'étape, ou de se préparer aux questions après un exposé.

Qu'est-ce que présentation-rapport ?

Cette compétence est conçue pour les chercheurs, ingénieurs ou étudiants qui doivent transformer un rapport technique, une thèse ou un projet en une présentation percutante, ou réviser et améliorer des diapositives existantes. Elle couvre l'ensemble du processus : cadrage, sélection du contenu, structure dramaturgique, conception des diapositives, construction d'un diaporama formaté (AsciiDoc/reveal.js ou LaTeX Beamer) avec notes de l'orateur et diagrammes, et vérification via un script `deck_stats.py`. Elle offre des conseils précis pour les soutenances, les présentations d'étape, les conférences et les interventions courtes, en insistant sur la différence fondamentale entre un rapport et un exposé oral. La compétence aide à créer un diaporama qui retient l'attention, respecte un temps imparti, et prépare à la prestation et aux questions-réponses. Elle est implémentée pour les assistants IA tels que Claude Code ou Cursor, et repose sur des fichiers de référence détaillés.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Présentations techniques

Un exposé est une création nouvelle, pas le rapport lu à voix haute. Un rapport atteint la tête ; un exposé touche aussi les tripes. Les lecteurs choisissent leur rythme et leur distance (30–40 cm) ; un auditeur voit chaque diapositive pendant quelques secondes, à 10 m de distance, tout en écoutant. Des mois de travail ne peuvent pas tenir en 20 minutes : l'exposé propose un « coup d'œil par le trou de la serrure » bien choisi que chaque auditeur peut suivre et mémoriser.

La méthode suit H. Hering (avec K.-G. Heyne), How to Write Technical and Scientific Reports (3e éd., Springer 2025), chap. 5.

Décidez de la tâche :

  • Créer un exposé/diaporama à partir d'un rapport ou de documents → sections 1–5
  • Réviser un diaporama ou un script existant → section 6
  • Répéter, présenter, répondre aux questions → references/delivery.md
  • Intervention courte (3–10 min, diapositives souvent improvisées) → references/delivery.md, « Intervention courte »

1. Cadre et objectif (écrivez-le d'abord)

Remplissez la fiche de cadrage à partir de references/talk-planning.md avec l'utilisateur, à partir de ce qu'il vous a donné ; ne demandez que ce qui modifie l'exposé :

  • sujet et titre de l'exposé (plus court et plus mémorisable que le titre du rapport, toujours précis)
  • public : qui, connaissances préalables, intérêts, attentes, qui décide
  • occasion et créneau horaire exact sans et avec discussion
  • type : cours magistral (informer), présentation technique (informer et influencer), présentation persuasive, discours d'occasion
  • objectifs pondérés, par ex. 70 % informer sur les résultats, 20 % montrer la compétence, 10 % détente et humour ; et le but sous-jacent (note, financement, décision, projet de suite)
  • salle, médias, configuration à distance/hybride ; orateurs précédents et suivants
  • confidentialité : divulgations claires avec le superviseur, le chef ou le client (et le marketing en entreprise) avant les exposés externes

2. Sélectionner le contenu

Ne gardez que l'essentiel, le significatif et le représentatif pour ce public et cet objectif. Mettez le reste dans une réserve (diapositives de secours, notes « peut ») pour le temps libre et les questions. Supprimez toute digression qui intéresse surtout l'auteur.

3. Créer la structure de l'exposé

Éloignez-vous des chapitres du rapport ; placez-vous du point de vue du public. Construisez quelques éléments courts et mémorisables avec une dramaturgie :

  • Commencez par quelque chose qui crée une tension (une question, un problème avec des conséquences concrètes, un exemple frappant) ; terminez en y répondant.
  • Répartition du temps environ 20 % introduction / 70 % partie principale / 10 % conclusion pour un exposé de 20 minutes (4/14/2 min). Pour 60 minutes, l'introduction et la conclusion augmentent moins que proportionnellement (8/48/4).
  • Partie principale pour un public mixte (règle des tiers), entrelacée, pas en blocs stricts : exemples bien connus et vue d'ensemble (≈1/3) → nouvel aperçu à un niveau que la plupart peuvent suivre (≈1/6) → détails d'expert (≈1/3), en revenant souvent au niveau général → agrégation, conclusions, évaluation que tout le monde comprend (≈1/6). Personne ne doit partir en pensant « je savais tout cela » ou « c'était trop compliqué ».
  • Introduction : contact, objectif de l'exposé, déroulement (diapositive de structure), délimitation (ce que vous ne couvrirez pas).
  • Conclusion : les résultats clés à nouveau, une brève perspective, rien de nouveau, une fin claire.

Consignez-la dans le schéma de conception de la structure (modèle dans references/talk-planning.md) avec les minutes par partie. Un rapport de 135 pages peut devenir une question d'ouverture, un élément principal avec trois sous-éléments, et une conclusion.

4. Diapositives

Lisez references/slide-design.md avant d'écrire les diapositives. L'essentiel :

  • « Le moins, c'est le mieux. » 5–7 éléments par diapositive ; mots-clés, pas de phrases (la diapositive récapitulative finale peut utiliser de courtes déclarations).
  • Chaque titre énonce le message de la diapositive en langage parlé (« L'aspiration intégrée élimine 90 % des fumées »), et correspond clairement à l'élément de structure actuel.
  • Visualisez au lieu d'écrire ; redessinez les figures du rapport pour la projection : moins d'éléments, traits plus épais, étiquettes beaucoup plus grandes. Ne collez jamais une figure de rapport ou d'article sans modification.
  • Texte pas plus petit qu'environ 1/30 de la hauteur de la diapositive (≈ 18 pt sur une diapositive classique) ; sans empattement ; deux tailles de police au maximum par diapositive ; couleur avec parcimonie et toujours avec un sens ; le noir sur blanc est le plus lisible ; le texte en couleur nécessite 1,5× la taille.
  • Pas d'encombrement répété sur chaque diapositive : pas de titre d'exposé, nom, date, compteur « Diapositive x sur y », longs pieds de page. Un petit numéro de diapositive est acceptable.
  • Trois diapositives de cadre : diapositive de titre ; diapositive de structure avec mots-clés du contenu (pas « Introduction / Partie principale / Résumé / Merci ») ; diapositive finale qui invite à la discussion (image clé, coordonnées). « Merci » et « Questions ? » se disent, ne s'affichent pas.
  • Gardez le public orienté : montrez à nouveau la structure aux transitions avec l'élément actuel mis en évidence.
  • Animation uniquement pour les constructions progressives de listes ou de processus ; jamais de mouvement ou de son décoratif.
  • Marquez les diapositives pouvant être sautées (réserve) à l'avance.

5. Construire le diaporama (asciidoctor-reveal.js ou Beamer)

Utilisez le format dans lequel l'utilisateur travaille : asciidoctor-reveal.js pour les projets AsciiDoc, LaTeX Beamer lorsque le rapport est en LaTeX ou qu'un diaporama PDF est requis (demandez en cas de doute).

  • reveal.js : references/revealjs-asciidoc.md : une section == par diapositive, notes de l'orateur [.notes] sur chaque diapositive de contenu, [%step] pour les constructions, diagrammes PlantUML avec polices adaptées à la taille de la diapositive, un CSS personnalisé avec la classe de surbrillance pour les diapositives de structure.
  • Beamer : references/beamer.md : une frame par diapositive avec un titre de message, \note{…} notes de l'orateur, superpositions pour les constructions, \AtBeginSection + \tableofcontents[currentsection] pour la diapositive de structure, symboles de navigation et pieds de page répétés désactivés.

Dans les deux formats, écrivez les notes de l'orateur sous forme de mots-clés, pas de texte intégral, balisées DOIT / DEVRAIT / PEUT (ce qui doit être dit, ce qui peut être coupé en cas de manque de temps, ce qui est en réserve) et avec un point de contrôle « fait à mm:ss » à chaque élément de structure.

Vérifiez ensuite :

python3 scripts/deck_stats.py deck.adoc --minutes 20      # ce répertoire de compétence
python3 scripts/deck_stats.py talk.tex --minutes 20       # Beamer : frames, \frametitle, \note, backup après \appendix

Il liste par diapositive les mots visibles, éléments et notes, estime le temps de parole à partir des notes (130 mots/min par défaut), et signale les diapositives surchargées, les phrases sur les diapositives, les titres manquants, les diapositives « Merci »/« Questions ? », les éléments d'ordre du jour génériques et les diapositives sans notes. Ajustez jusqu'à ce que le temps prévu soit inférieur au créneau (les exposés en direct durent plus longtemps que ne le suggèrent les notes) et que chaque signalement soit soit corrigé, soit un choix délibéré (une diapositive experte courte et dense peut être intentionnelle).

Livrez : le fichier du diaporama (et le CSS personnalisé), la fiche de cadrage et le schéma de conception de la structure, le tableau de minutage, et une liste des diapositives de réserve. Recommandez un essai complet chronométré avec un auditeur (voir references/delivery.md).

6. Réviser un diaporama ou un script existant

  1. Obtenez le cadre : public, créneau, objectif. Sans cela, les commentaires sur les diapositives sont des suppositions.
  2. Exécutez deck_stats.py (diaporamas AsciiDoc ou Beamer) ou extrayez le texte des diapositives (.pptx/PDF) et comptez les mêmes éléments en lisant.
  3. Vérifiez l'exposé dans son ensemble : est-ce une création nouvelle ou la table des matières du rapport sur diapositives ? Tension d'ouverture et question répondue ? Répartition 20/70/10 ? Mélange selon la règle des tiers (trop superficiel pour les experts ou trop de jargon pour les autres) ? Théorie d'abord et exemples tard (défaut fréquent) ? Résumés intermédiaires ? Contenu de réserve ? Fin claire ?
  4. Vérifiez chaque diapositive par rapport à references/slide-design.md.
  5. Rapportez par sévérité (critique : ne correspond pas au créneau, mauvais niveau pour le public, pas de message ; majeur : diapositives surchargées ou illisibles, figures de rapport inchangées, orientation de structure manquante ; mineur : détails de style). Pour chaque constatation sur une diapositive, donnez le numéro/titre de la diapositive et une réécriture concrète (nouveau titre, liste coupée, description de figure redessinée). Pour une évaluation de type notation d'un exposé présenté, utilisez le formulaire d'évaluation dans 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 associés