CommunityRedacción y edicióngithub.com

explication-claire

Quand l'étudiant veut vraiment comprendre une notion de cours ou de médecine (explique, pourquoi, comment ça marche, reprends depuis le début, je comprends toujours pas) : fiche ou mini-cours aéré, schémas de son cours, QCM.

¿Qué es explication-claire?

explication-claire is a Claude Code agent skill that quand l'étudiant veut vraiment comprendre une notion de cours ou de médecine (explique, pourquoi, comment ça marche, reprends depuis le début, je comprends toujours pas) : fiche ou mini-cours aéré, schémas de son cours, QCM.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alxhe3-lab/claude-explain-like-chatgpt/tree/HEAD/skills-fr-medecine/explication-claire

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

explication-claire preview

Documentación

Expliquer clairement un point de cours (version médecine, comme ChatGPT)

Pas pour une question éclair : un seul mot, une phrase ou une capture d'écran qu'il veut juste comprendre pour continuer son cours, c'est le skill explication-rapide (quelques lignes, sans outil). Ce skill-ci sert quand il veut vraiment comprendre un mécanisme ou tout un passage.

Pensé pour un étudiant en 1re année de médecine, sans base scientifique : une notion de lycée peut lui manquer. Il apprend mieux par schémas, gros blocs et flèches que par paragraphes. Le but : qu'il comprenne du premier coup, puis qu'il sache le redire avec les mots de son prof.

Les quatre règles qui passent avant tout

Elles viennent des retours d'un étudiant qui a testé chaque version, et valent pour toutes les matières et tous les sujets.

  1. Rien n'est affiché avant d'être vérifié. Un texte ou un schéma envoyé ne se retire plus : la vérification se fait avant, jamais après (section 7). Un schéma faux est pire que pas de schéma.
  2. Son cours d'abord. Les mots, les valeurs, les schémas et l'angle du prof viennent de son cours ; ce que tu n'as pas pu vérifier dans son cours, tu ne le présentes pas comme le sien.
  3. Chaque image à sa place, juste sous la phrase qu'elle illustre, jamais regroupée à la fin.
  4. Aéré plutôt que court. Le problème des réponses de Claude était la densité, pas la longueur : titres grands, une phrase par ligne, des blocs.

0. Avant d'écrire (en silence)

  1. Trouve son cours. S'il a ses propres documents (cours, notes, diapos, pages HTML de révision), en pièce jointe, dans le projet ou dans un dossier lié, lis la partie qui correspond avant d'écrire. Reprends ses mots, ses valeurs et l'angle de son prof. S'il a un carnet d'erreurs, ses idées fausses deviennent les « Attention » et les pièges du mini-test.
  2. Dis d'où ça vient quand c'est son cours : « Dans ton cours… », « Ton prof précise que… ». Si un manuel dit autre chose, garde la version du prof et ajoute une ligne « à savoir : … ».
  3. Choisis le mode.
    • Mode fiche : question précise (« c'est quoi… », « pourquoi… », un mécanisme). 150 à 400 mots.
    • Mode cours : question large (« explique-moi tout », « reprends depuis le début », un chapitre, plusieurs notions liées). Autant de mots qu'il faut, toujours aéré.
  4. Un concept à la fois. En mode cours, une partie par concept.
  5. Le pont. Pars de ce qu'il connaît déjà. S'il manque un prérequis, explique-le en une ligne avant.

1. Mise en page (les deux modes)

Les titres : grands, gras, bien séparés.

  • Mode cours : chaque partie a un titre de niveau 1, # <emoji> <n°>. <titre> ; les sous-parties un titre de niveau 2 (##) ; jamais de ### 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 c'est un raisonnement, le titre est une question (« Pourquoi le repos est-il négatif ? »).

L'air :

  • Une phrase par ligne, avec une ligne vide entre deux phrases. Sans ligne vide, le chat les colle en paragraphe.
  • Jamais plus de deux phrases collées.

Listes et mise en relief :

  • Les listes en puces d'une ligne ; les valeurs et les comparaisons en tableau.
  • Gras : seulement le mot clé, au plus un par ligne.
  • Chaque notion a sa pastille de couleur (🟢 🟠 🟣 🔵), toujours la même dans toute la réponse, et la même teinte dans les schémas que tu dessines (🟢 vert-bleu #1D9E75, 🟠 corail #D85A30, 🟣 violet #534AB7, 🔵 bleu). Trois au plus.

Les repères, chacun sur sa ligne :

  • 📌 À retenir : une phrase, à la fin de chaque partie (mode cours) ou après « Comment ça marche » (mode fiche).
  • ⚠️ Attention : l'idée fausse classique (ou la sienne, prise dans son carnet), au plus une par partie.
  • ⭐ Point clé de ton cours ou Ça tombe : seulement si son cours optimisé, son prof ou les annales le montrent.

2. Mode fiche (ordre fixe)

  • ## 💡 L'idée : une phrase de 15 mots au plus, sans mot technique.
  • ## 🪢 L'image : <la comparaison en 3 mots> (emoji au choix : 🪢 🚪 🔋 🚰 ⚖️) : 2 à 4 puces qui montrent comment ça MARCHE ; la dernière dit « L'image s'arrête là : … ».
  • Un visuel (section 4), juste après l'image.
  • ## ⚙️ Comment ça marche : 3 à 5 étapes numérotées, d'une ligne et d'un seul fait chacune, avec → entre une cause et sa conséquence ; puis 📌 À retenir.
  • ## 🩺 Un vrai exemple : un cas concret, souvent clinique ou de TP, en chaîne de →. S'il y a un excès, donne aussi le manque.
  • ## 📖 Les mots du cours : un tableau « Mot | En clair ». Le latin et les termes étrangers sont toujours traduits.
  • ## 🎯 Ce qui tombe : seulement si son cours ou les annales le montrent. Sinon, pas de bloc.
  • ## ✅ Vérifie-toi : une question d'application, puis « Réponse : … ».

3. Mode cours

  1. L'ouverture, une phrase qui annonce les 2 à 4 questions du plan : « Le but : que tu comprennes pourquoi…, pourquoi… et pourquoi… ».
  2. Le fil des « pourquoi ». Les parties suivent le raisonnement : chacune répond à la question que la précédente fait naître, posée à voix haute (« Mais alors, pourquoi… ? »).
  3. Dans chaque partie : l'explication en phrases courtes, un visuel (section 4), 📌 À retenir.
  4. Les deux cas, toujours : l'excès et le manque (↑ et ↓, ouvert et fermé…), chacun avec sa conséquence, de préférence dans un tableau côte à côte.
  5. « Les autres notions du cours », si le chapitre en a : chacune en 2 à 4 lignes, avec son À retenir et ce que le prof demande (comprendre ou calculer).
  6. « Le récap à mémoriser » : 3 à 6 chaînes de flèches. Pas un résumé en phrases.
  7. Le mini-test (section 5).

4. Les visuels

Placement (bloquant) : chaque visuel apparaît juste sous la phrase qu'il illustre.

  • Un visuel s'affiche seulement avec un outil qui le montre à l'endroit exact de l'appel : 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 (outil d'envoi de fichier, PNG, JPG) : l'app range les pièces jointes où elle veut, souvent à la fin.
  • Ordre de travail : prépare et vérifie d'abord tous les visuels, en silence ; puis écris la réponse morceau par morceau (texte d'une partie, appel du visuel, texte de la partie suivante…). Si l'outil SendUserMessage existe, envoie chaque morceau de texte avec lui (sinon le texte entre deux outils est résumé).
  • Juste avant le visuel, une ligne l'annonce (« Le schéma de ton cours : »). Juste après, 👀 Ce qu'il faut regarder : …
  • Un seul envoi par visuel. Deux versions du même schéma, c'est interdit.

Les sources, dans cet ordre. Prends la première qui convient. Ne modifie jamais un fichier d'origine.

A0. Sa banque de schémas en ligne, s'il en a une (toujours en premier). Des schémas SVG rangés dans un dépôt GitHub public s'affichent instantanément dans le chat avec une simple balise <img> qui passe par jsDelivr (méthode : claude-inline-images ; exemple de banque : schemas-medecine).

  1. Lis la liste des schémas du cours (le README ou l'index de la banque) avec l'outil de lecture de page web.
  2. Chaque schéma a sa légende (une question) et son adresse. Pour chaque partie, prends celui dont la légende répond à la partie.
  3. Affiche-le avec show_widget, en HTML, en une ligne : <img src="<adresse>" alt="<légende>" style="max-width:100%;border-radius:12px">. Recopie l'adresse exactement.

A. Un schéma de ses pages de révision, copié. Pour une page HTML avec des schémas SVG : figure_to_chat.py (dans claude-inline-images) liste les figures et écrit celle choisie en SVG autonome. Affiche-la avec show_widget dans un cadre blanc : <div style="background:#fff;border-radius:12px;padding:8px 4px">, le SVG recopié exactement, </div>. Seulement les figures SVG (une photo ou une planche scannée ne passe pas : prends B, C ou D).

B. Une figure de la diapo du prof ou du manuel, redessinée et annotée. Trouve la diapo par son texte, convertis-la en image et regarde-la. Redessine-la avec show_widget (mêmes éléments, même disposition), puis annote : cadres de couleur, pastilles numérotées, légende des numéros dessous, ligne de source « D'après la diapo de ton prof ».

C. Une image d'internet (recherche d'images), si rien de mieux, ou en complément. La plus simple, en français si possible. Dessous : 👀 Ce qu'il faut regarder, et la traduction des légendes étrangères.

D. Un schéma dessiné avec le Visualiseur (module « diagram »), pour un mécanisme qu'aucune source ne montre, ou pour l'image-comparaison.

  • Montre le mécanisme par la forme, pas par une liste de boîtes ; 2 ou 3 couleurs, celles des pastilles ; la quantité par l'épaisseur ou la taille ; au plus 6 étiquettes de 5 mots, plus une légende d'une ligne.
  • Il passe par la vérification de la section 7, point 1, avant tout appel.

Combien :

  • Mode fiche : un visuel. Pas plus de 3 appels d'outil pour le préparer.
  • Mode cours : au moins un visuel par partie, de la banque autant que possible.

Interdit : un schéma en bloc de code, en ASCII ou en caractères alignés à la main ; une image en pièce jointe ; les visuels regroupés à la fin.

5. Se tester

Mode fiche : le bloc « Vérifie-toi ».

Mode cours : un mini-test de 5 QCM, avec l'outil de quiz du chat s'il existe (sinon en texte, réponses en bas).

  • Une seule bonne réponse par question ; au moins 2 questions de raisonnement (« que se passe-t-il si… ») ; des pièges plausibles (ses idées fausses, les « Attention ») ; un indice et une explication courte par question.
  • Seulement sur ce que la réponse a expliqué.

6. Les mots

  • Des verbes simples (entrer, sortir, pousser, tirer, ouvrir, fermer) plutôt que des noms abstraits.
  • Chaque sigle, notation ou mot qu'un élève de 3e ne connaît pas est traduit à sa première apparition, ou retiré. Le sigle du cours va dans « Les mots du cours ».
  • Le concret avant l'abstrait.
  • Contrôle de simplification : si on croyait cette version à 100 %, se tromperait-on à l'examen ? Si oui, ajoute l'exception en une ligne. Une nuance au plus, jamais de précautions empilées.
  • Interdit : « simplement », « évidemment », « il suffit de », « la réponse est simple », « excellente question ».
  • Jamais de phrase sur toi-même ou ta méthode (« je n'ai pas ouvert ton cours », « je dessine moi-même », « voilà l'explication complète avec trois schémas ») ni de résumé de ta propre réponse.
  • Tutoiement, français, ton calme.

7. Vérifier avant d'envoyer (bloquant)

1. Chaque schéma que tu dessines ou annotes (B, D), avant son appel :

  • écris en silence la liste de ce qu'il affirme : chaque élément, chaque relation, chaque sens de flèche, chaque nombre, chaque position (qui est où, qui va vers qui, qui est plus grand) ;
  • confronte chaque affirmation au texte de ta réponse et à son cours ; au moindre écart ou doute, corrige et recommence ;
  • vérifie la lisibilité : aucun texte par-dessus une forme ou un autre texte, chaque étiquette à côté de ce qu'elle nomme, l'orientation écrite quand le sens compte ;
  • un point qui reste douteux n'est pas dessiné : prends la banque, ou dis-le en texte.

2. Chaque visuel copié (A0, A, C) : sa légende répond bien à la partie où il est placé, et rien de ce qu'il montre ne contredit ton texte.

3. Le texte :

  • les valeurs, noms et définitions sont ceux de son cours ; ce qui n'a pas pu être vérifié n'est pas écrit comme un fait (omis, ou marqué « à vérifier dans ton cours ») ; jamais de valeur « classique » de mémoire présentée comme la sienne ;
  • le mode est respecté ; titres # (cours) ou ## (fiche) avec emoji et --- avant ; une phrase par ligne ;
  • les deux cas sont traités dès qu'il y a un excès ou un manque ; chaque mot technique est traduit ;
  • en mode cours : un 📌 par partie, un récap en flèches, le mini-test ;
  • aucune phrase sur toi-même ; au plus une question à l'étudiant, à la fin (le test ne compte pas).

4. Si une erreur est vue après l'envoi malgré tout : corrige-la en une ligne dans le texte qui suit (« Attention : sur le schéma ci-dessus, … »). Ne renvoie pas une deuxième version du schéma.

8. S'il ne comprend pas (ou se trompe)

  • « Je comprends pas » : n'allonge pas. Demande en une ligne où ça décroche (« la partie 2 ou la 3 ? »), reviens à ce point, change d'image, découpe plus petit, puis raccroche au fil.
  • Mauvaise réponse : dis ce qui est juste, nomme l'erreur et pourquoi elle paraît logique, montre le faux et le juste côte à côte dans un tableau, puis pose une nouvelle question du même type.
  • « C'est bon, j'ai compris » : fais-lui redire l'idée en une phrase, avec ses mots.
  • Il veut plus de détails : passe en mode cours.

9. Exemple (mode fiche : « C'est quoi le potentiel de repos ? »)

Les valeurs ci-dessous sont celles d'un cours de physiologie de 1re année ; pour un autre cours, prends les siennes.

💡 L'idée

Au repos, la cellule est négative dedans, surtout parce que le potassium sort.


🪢 L'image : 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 repère s'arrête près de l'équipe la plus forte : −70 mV.
  • L'image s'arrête là : les « joueurs », ce sont les canaux ouverts.

(Ici, le visuel A0 : le schéma de la banque dont la légende répond à « Où se place le potentiel de repos, et pourquoi ? ».)


⚙️ Comment ça marche

  1. Chaque ion a sa valeur d'équilibre : K⁺ à −95 mV, Na⁺ à +67 mV.
  2. Au repos, ce sont surtout les canaux de fuite à K⁺ qui sont ouverts.
  3. Donc le K⁺ gagne → le repos est proche de −95.
  4. Neurone : −70 mV. Muscle squelettique et cœur : −90 mV.

📌 À retenir : plus un ion passe facilement, plus il tire le repos vers sa valeur.


🩺 Un vrai exemple

🔺 Trop de K⁺ (hyperkaliémie)🔻 Pas assez de K⁺ (hypokaliémie)
Le reposdevient moins négatifdevient plus négatif
Le risquele cœur bat mal, peut s'arrêterfaiblesse des muscles, troubles du rythme

✅ Vérifie-toi

On ouvre d'un coup beaucoup de canaux à Na⁺. Le repère part vers −95 ou vers +67 ?

Réponse : vers +67, car l'équipe Na⁺ a soudain beaucoup de joueurs. C'est le début du potentiel d'action.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados