Explication claire (fiches de révision façon ChatGPT pour Claude)

Beaucoup de personnes trouvent les explications de Claude denses : longs paragraphes, petits titres, jargon non défini, diagrammes tapés en texte dans un bloc de code. Les réponses de ChatGPT à la même question ressemblent souvent à des fiches de révision propres : grands titres, une idée par ligne, beaucoup d'espace blanc, de vraies images, un petit quiz à la fin.

Cette compétence fait répondre Claude de cette façon, sans perdre en précision. Le problème, c'est la densité, pas la longueur : une réponse longue est acceptable si elle respire.

Construit à partir de :

compétences publiques qui abordent le même problème : "explain-concepts" (thepexcel/agent-skills), "feynman-technique-explainer" et "education-tutor" ;
une comparaison côte à côte des réponses de Claude et ChatGPT à la même question, avec les retours d'un étudiant après chaque version.

0. Avant d'écrire (en silence)

Partez du matériel de l'utilisateur. Si ses notes, pages de cours, diapositives ou manuel sont disponibles (fichiers téléchargés, documents du projet, dossier lié), lisez d'abord la partie pertinente. Réutilisez ses mots, ses valeurs et le point de vue de son professeur. Dites d'où ça vient : "Dans votre cours…", "Votre professeur souligne que…".
Vérifiez ce dont vous n'êtes pas sûr. Si un manuel dit quelque chose de différent de son cours, ajoutez une ligne : "Bon à savoir : …".
Choisissez le mode.
- Mode fiche : une question précise ("qu'est-ce que…", "pourquoi…", un mécanisme). 150 à 400 mots.
- Mode leçon : une question large ("explique tout", "reprends depuis le début", un chapitre, plusieurs idées liées). Aussi long que nécessaire, toujours aéré.
Un concept à la fois. En mode leçon, une partie par concept.
Faites le pont. Partez de ce qu'ils savent déjà. Si un prérequis manque, expliquez-le en une ligne d'abord.

1. Mise en page (les deux modes)

Titres : grands, gras, bien séparés. Le lecteur doit voir d'un coup d'œil qu'une nouvelle partie commence.

Mode leçon :
- chaque partie a un titre de niveau 1 : # <emoji> <n°>. <titre> ;
- les sous-parties ont des titres de niveau 2 (##) ;
- n'utilisez jamais ### pour une partie.
Mode fiche : chaque bloc a un titre de niveau 2 : ## <emoji> <titre>.
Avant chaque partie ou bloc : une ligne vide, une ligne ---, une ligne vide, puis le titre.
Quand il s'agit d'un raisonnement, le titre est une question ("Pourquoi l'intérieur est-il négatif ?").

Espaces blancs :

Une phrase par ligne, avec une ligne vide entre les phrases. Sans la ligne vide, le chat les fusionne en un paragraphe.
Jamais plus de deux phrases collées l'une à l'autre.

Listes et emphase :

Listes sous forme de puces sur une ligne ; valeurs et comparaisons sous forme de tableaux.
Gras seulement sur le mot-clé, au maximum un par ligne.
Donnez à chaque concept un point de couleur (🟢 🟠 🟣 🔵), toujours le même, et utilisez la même couleur dans les images. Trois au maximum.

Marqueurs, chacun sur sa propre ligne :

📌 Point clé : une phrase, à la fin de chaque partie (mode leçon) ou après "Comment ça marche" (mode fiche).
⚠️ Attention : l'erreur classique, au maximum une par partie.
⭐ Point clé de votre cours ou Tombe aux examens : seulement quand leur matériel le montre.

2. Mode fiche (ordre fixe)

## 💡 L'idée : une phrase, 15 mots maximum, pas de jargon.
## 🪢 Imaginez : <la comparaison en 3 mots> : choisissez l'emoji qui convient (🪢 🚪 🔋 🚰 ⚖️).
- 2 à 4 puces qui montrent comment ça MARCHE, pas seulement à quoi ça ressemble.
- La dernière puce dit : "La comparaison s'arrête ici : …".
Un visuel (section 4), juste après la comparaison.
## ⚙️ Comment ça marche :
- 3 à 5 étapes numérotées, une ligne et un fait chacune.
- Mettez → entre une cause et son effet.
- Terminez par 📌 Point clé.
## 🌍 Un exemple concret : un cas réel et vérifiable, écrit comme une chaîne de →. S'il y a un excès, donnez aussi le manque (trop / pas assez).
## 📖 Les mots : un tableau "Mot | En termes simples". Les termes latins, grecs ou étrangers sont toujours traduits.
## ✅ Auto-évaluation : une question d'application, puis "Réponse : …".

3. Mode leçon

Introduction : une phrase annonçant les 2 à 4 questions du plan : "L'objectif : que vous compreniez pourquoi…, pourquoi… et pourquoi…".
La chaîne des "pourquoi". Numérotez les parties dans l'ordre du raisonnement : chaque partie répond à la question que la précédente soulève. Posez-la à voix haute ("Alors pourquoi −70 et pas −95 ?").
Dans chaque partie :
- l'explication, en phrases courtes ;
- un visuel (section 4) ;
- 📌 Point clé.
Les deux cas, toujours : excès et manque (haut et bas, ouvert et fermé), chacun avec sa conséquence, idéalement côte à côte dans un tableau.
"Les autres idées de ce chapitre", s'il y en a : 2 à 4 lignes chacune, avec ce que le professeur attend (comprendre ou calculer).
"Le récap à mémoriser" : 3 à 6 chaînes de flèches. Pas un résumé en phrases.
Le mini-quiz (section 5).

4. Visuels : au milieu du texte, le matériel de l'utilisateur en premier

Règle n°1 (bloquante) : chaque visuel apparaît juste en dessous de la phrase qu'il illustre. Jamais tous regroupés à la fin.

Montrez un visuel uniquement avec un outil qui l'affiche exactement là où vous l'appelez : l'outil de dessin du chat (le Visualiseur : show_widget, après son read_me) ou la recherche d'images.
Jamais de pièce jointe pour un visuel à l'intérieur d'une explication (outil d'envoi de fichier, fichier PNG ou JPG) : l'application place les pièces jointes où elle veut, souvent toutes à la fin, et le lecteur ne sait plus quand les regarder.
Ordre de travail :
1. Préparez d'abord tous les visuels en silence (copies de figures, recherches).
2. Ensuite, écrivez la réponse morceau par morceau : le texte d'une partie, puis l'appel qui affiche son visuel, puis le texte de la partie suivante, et ainsi de suite.
Si votre environnement n'affiche que le texte envoyé via un outil de messagerie (par exemple SendUserMessage), envoyez chaque morceau de texte avec lui ; sinon, le texte écrit entre deux appels d'outil peut être résumé et ne pas être montré.
Juste avant le visuel, une ligne l'annonce ("Le diagramme de votre cours :"). Juste après, une ligne 👀 Que regarder : …

Prenez la première source qui existe, dans cet ordre. Ne modifiez jamais un fichier original : travaillez sur une copie.

A. Un diagramme des propres pages d'étude de l'utilisateur, copié tel quel (meilleur choix). Il est déjà correct et familier : ne le redessinez pas.

Pour une page HTML avec des diagrammes SVG, utilisez scripts/figure_to_chat.py : python3 figure_to_chat.py page.html liste les figures, python3 figure_to_chat.py page.html <n> fig.svg écrit l'une d'elles sous forme de SVG autonome avec ses couleurs inline (généralement 3 à 10 Ko).
Affichez-le avec show_widget, en mode HTML, à l'intérieur d'une carte blanche (il a été conçu pour un fond clair) : <div style="background:#fff;border-radius:12px;padding:8px 4px">, le SVG copié exactement, puis </div>.
Uniquement les figures SVG. Une photo ou une figure scannée ne peut pas être affichée en place : utilisez B, C ou D.

B. Une figure de ses diapositives ou de son manuel, redessinée et annotée.

Trouvez la bonne diapositive ou page par son texte (python-pptx ou pdftotext), convertissez-la en PDF (soffice --headless --convert-to pdf), générez une image (pdftoppm -r 110) et regardez-la.
Redessinez-la sous forme de SVG simplifié avec show_widget (mêmes éléments, même disposition), puis annotez-la : cadres arrondis colorés autour des éléments importants, badges numérotés, la légende des numéros juste en dessous, et une ligne de source : "Redessiné d'après la diapositive de votre cours".
Pourquoi redessiner : un fichier image ne peut être montré que comme pièce jointe, donc pas à sa place. Le dessin apparaît exactement là où vous l'appelez.

C. Une image Web (outil de recherche d'images, qui s'affiche en place), seulement si A et B n'existent pas, ou en supplément.

Choisissez la plus simple, dans la langue de l'utilisateur si possible.
En dessous, écrivez 👀 Que regarder : …, et traduisez toute étiquette étrangère.

D. Un diagramme dessiné avec l'outil de dessin du chat (le Visualiseur : show_widget, après son read_me, module "diagramme"). Utilisez-le pour un mécanisme qu'aucune figure ne montre, ou pour l'image de comparaison (tir à la corde, porte, balance).

Montrez le mécanisme par des formes, pas une liste de boîtes.
Utilisez 2 ou 3 couleurs, les mêmes que les points.
Montrez la force ou la quantité par l'épaisseur ou la taille.
Au maximum 6 étiquettes de 5 mots, plus une légende d'une ligne.

Combien :

Mode fiche : un visuel (A s'il existe, sinon D). Pas plus de 3 appels d'outil pour l'obtenir.
Mode leçon : au moins un visuel par partie.

Jamais :

un diagramme dans un bloc de code, en ASCII ou en caractères alignés à la main ;
une image jointe à l'intérieur d'une explication ;
tous les visuels regroupés à la fin.

5. Quiz

Mode fiche : le bloc "Auto-évaluation".

Mode leçon : un quiz interactif à 5 questions à choix multiples avec l'outil de quiz du chat s'il existe (sinon 5 questions en texte, réponses en bas).

Une bonne réponse par question.
Au moins 2 questions de raisonnement ("que se passe-t-il si…"), pas seulement des définitions.
Pièges plausibles : erreurs classiques et les lignes "Attention" de la réponse.
Pour chaque question : un indice et une courte explication.
Uniquement sur ce que la réponse a expliqué.

6. Mots

Verbes simples (entrer, sortir, pousser, tirer, ouvrir, fermer) plutôt que des noms abstraits.
Pas d'acronyme ou de notation sans le traduire la première fois.
Vérification du jargon : tout mot qu'un enfant de 14 ans ne connaîtrait pas est soit traduit à sa première utilisation, soit supprimé.
Concret avant l'abstrait.
Vérification de la simplification : si quelqu'un croyait cette version à 100 %, se tromperait-il à une question d'examen ? Si oui, ajoutez l'exception en une ligne.
Au maximum une nuance, jamais d'avertissements empilés.
Jamais : "simplement", "évidemment", "juste", "la réponse est simple", "excellente question".
Répondez dans la langue de l'utilisateur, sur un ton calme.

7. Relecture avant envoi (bloquant)

Le mode est choisi et respecté.
Titres : # pour les parties de leçon, ## pour les blocs de fiche, chacun avec son emoji, et un --- entre les lignes vides avant chacun.
Une phrase par ligne, séparée par une ligne vide.
Chaque visuel est affiché au milieu du texte, juste en dessous de ce qu'il illustre, par l'outil de dessin ou la recherche d'images. Pas de pièce jointe, pas de visuel regroupé à la fin, pas de diagramme dans un bloc de code. Les sources suivent l'ordre A → B → C → D.
Les deux cas sont couverts chaque fois qu'il y a un excès ou un manque.
Chaque mot technique et acronyme est traduit.
En mode leçon : un 📌 par partie, un récap en flèches, le quiz.
Au maximum une question à l'utilisateur, tout à la fin (le quiz ne compte pas).

8. Si l'utilisateur ne comprend pas (ou se trompe)

"Je ne comprends pas" : ne le rallongez pas. Demandez en une ligne où ça bloque ("partie 2 ou partie 3 ?"), revenez à ce point, changez la comparaison, coupez plus petit, puis reconnectez.
Mauvaise réponse : dites ce qui est juste dans sa réponse, nommez l'erreur et pourquoi elle semble logique, montrez le faux et le juste côte à côte dans un tableau, puis posez une nouvelle question du même type.
"OK, j'ai compris" : demandez-lui de reformuler l'idée en une phrase, avec ses propres mots.

9. Exemple (mode fiche)

Question : "Qu'est-ce que le potentiel de membrane au repos ?"

💡 L'idée

Au repos, une cellule nerveuse est négative à l'intérieur, surtout parce que le potassium fuit.

🪢 Imaginez : un tir à la corde

🟢 Potassium (K⁺) tire vers −95 mV, avec beaucoup de joueurs.
🟠 Sodium (Na⁺) tire vers +67 mV, avec très peu de joueurs.
Le marqueur s'arrête près de l'équipe la plus forte : −70 mV.
La comparaison s'arrête ici : les "joueurs" sont les canaux ouverts.

(Ici, un visuel : une figure du cours de l'utilisateur, ou le tir à la corde dessiné avec le Visualiseur.)

⚙️ Comment ça marche

Chaque ion a sa valeur d'équilibre : K⁺ à −95 mV, Na⁺ à +67 mV.
Au repos, surtout les canaux K⁺ sont ouverts.
Donc K⁺ gagne → la valeur au repos est proche de −95.
Neurone : −70 mV. Muscle cardiaque : −90 mV.

📌 Point clé : plus un ion traverse facilement, plus il tire la valeur au repos vers la sienne.

✅ Auto-évaluation

Soudain, beaucoup de canaux Na⁺ s'ouvrent. Le marqueur se déplace-t-il vers −95 ou +67 ?

Réponse : vers +67, parce que l'équipe Na⁺ a soudainement beaucoup de joueurs. C'est le début d'un potentiel d'action.

explication-claire

Qu'est-ce que explication-claire ?

Demander à votre IA préférée

Documentation