CommunityRédaction et éditiongithub.com

Quiz Maker

Créez des quiz interactifs et pédagogiques avec explications, dérivations et citations vérifiables.

Qu'est-ce que Quiz Maker ?

Quiz Maker est une compétence conçue pour générer des quiz interactifs au format HTML, alliant évaluation et apprentissage. Contrairement aux quiz automatiques classiques, chaque question est accompagnée d'une explication simplifiée, d'une dérivation détaillée pour les sujets quantitatifs, et d'une citation réelle vérifiable. La compétence prend en charge la génération de quiz dans cinq niveaux de difficulté (Fondamental, Intermédiaire, Avancé, Expert, Doctorat/Recherche) et adapte automatiquement le vocabulaire, la profondeur des explications et le type de questions (choix multiples, réponses numériques, questions ouvertes). Le résultat est un fichier HTML unique et interactif, prêt à être ouvert dans un navigateur, avec notation intégrée, révélations progressives des dérivations et liens de citation. La compétence insiste sur la recherche systématique de sources vérifiables via le web pour les sujets techniques, et sur l'adaptation du contenu au profil et au domaine de l'utilisateur. Elle est conçue pour fonctionner avec des outils comme Claude, Cursor ou Codex, et s'intègre via un fichier SKILL.md détaillant le processus complet de création de quiz.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add AlbertFD/AlbertFD-skills

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

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

Documentation

Que fait Quiz Maker ?

Un bon quiz fait deux choses à la fois : il teste ce que quelqu'un sait, et il lui apprend au moment où il se trompe. La plupart des quiz auto-générés ne font que la première — une question brute, une bonne réponse, rien qui aide l'apprenant à comprendre pourquoi. Cette compétence existe pour bien faire la seconde. Chaque question est accompagnée d'une explication simplifiée que l'apprenant peut réellement suivre, de l'équation ou de la dérivation qui la sous-tend lorsque le sujet est quantitatif, et d'une citation réelle pour approfondir et vérifier la réponse.

Le résultat est un fichier HTML interactif unique que l'utilisateur peut ouvrir dans un navigateur, répondre à son rythme, s'auto-évaluer, révéler les dérivations détaillées et obtenir un score. Cela doit ressembler à un outil d'étude bien conçu, pas à une simple impression.

La règle primordiale : demander la difficulté avant de construire

La difficulté change tout dans le quiz — le vocabulaire, le fait d'afficher une dérivation ou simplement un résultat, le nombre d'étapes d'un problème, le niveau de connaissances présupposé. Vous ne pouvez donc pas écrire une seule bonne question avant de connaître le niveau. Demandez à l'utilisateur quel niveau il souhaite avant de générer le quiz, en utilisant l'outil AskUserQuestion avec ces cinq options :

  • Fondamental — première exposition. Langage simple, exemples concrets, jargon minimal, résultats énoncés sans dérivation. Pensez à un débutant curieux ou à un élève de collège.
  • Intermédiaire — à l'aise avec les bases. Introduction de la terminologie standard et d'un raisonnement simple en une ou deux étapes. Pensez à un lycéen avancé ou à un étudiant de premier cycle débutant.
  • Avancé — solides connaissances opérationnelles. Problèmes en plusieurs étapes, maîtrise du formalisme de base attendue, courtes dérivations présentées. Pensez à un étudiant de licence avancée.
  • Expert — maîtrise approfondie. Cas limites non évidents, liens entre les concepts, dérivations complètes attendues. Pensez à un étudiant de master.
  • Doctorat / Recherche — frontière de la connaissance. Hypothèses subtiles, débats actuels, dérivations rigoureuses, citations de la littérature primaire. Pensez à un examen de qualification ou à un séminaire de recherche.

Si l'utilisateur a déjà indiqué un niveau dans son message (« donne-moi un quiz de niveau doctorat difficile sur... »), faites correspondre à l'option la plus proche et confirmez plutôt que de redemander. Pendant que vous demandez la difficulté, il est efficace de confirmer également le sujet (s'il est flou) et le nombre de questions souhaité (8 par défaut) dans le même appel AskUserQuestion — mais la difficulté est ce que vous ne devez jamais sauter.

Bien cerner le sujet

Évaluez le contexte avant de demander. Le sujet peut déjà être évident d'après le message de l'utilisateur, les instructions du projet, les fichiers du dossier ou la conversation en cours. Si l'utilisateur travaille dans un domaine spécialisé (son profil ou son CLAUDE.md l'indique souvent), choisissez des exemples dans son domaine plutôt que génériques — un physicien a droit à l'antimatière et aux sections efficaces, pas à « une balle qui roule sur une pente », sauf s'il l'a demandé. Ne demandez des clarifications que lorsque le sujet est vraiment ambigu ou trop large pour constituer un quiz cohérent (« science » est trop large ; « relativité restreinte — dilatation du temps et contraction des longueurs » est un quiz).

Recherchez et citez — ne fabriquez jamais

Chaque explication est accompagnée d'une citation, et la citation doit être réelle. C'est la différence entre un outil d'étude digne de confiance et une hallucination plausible.

Pour les sujets techniques, scientifiques, médicaux, historiques ou en évolution rapide, effectuez une recherche sur le web pour étayer l'explication et trouver une source vérifiable — un manuel avec édition et chapitre, un article de synthèse avec DOI, un organisme de normalisation, un site de référence réputé. Privilégiez les sources primaires et faisant autorité plutôt que les blogs. Capturez une URL ou un DOI réel pour que la citation soit accessible.

Pour les sujets stables et de culture générale où vous avez un haut niveau de confiance (arithmétique de base, définitions bien établies), il est acceptable de citer une référence standard de mémoire sans recherche en direct — mais nommez une source spécifique et vérifiable (par exemple « Griffiths, Introduction to Electrodynamics, 4e éd., §2.3 »), jamais un vague « manuels » ou un numéro de page inventé.

Si vous ne parvenez pas à trouver une source réelle pour une affirmation, c'est le signe que l'affirmation est peut-être fragile — reformulez la question autour de ce que vous pouvez sourcer, plutôt que d'inventer une citation. Inventer une citation est pire que de n'en avoir aucune.

Rédigez les questions

Visez une variété qui exerce réellement la compréhension, pas seulement la mémorisation. Les bons quiz s'appuient sur des questions qui font appliquer une idée à l'apprenant. Variez le format :

  • Choix multiples — la base, auto-corrigeable, et les mauvaises options sont une opportunité d'apprentissage. Rendez les distracteurs plausibles : chaque mauvaise réponse doit correspondre à une erreur ou à un concept erroné spécifique et courant, afin que la choisir apprenne quelque chose à l'apprenant. Évitez les options plaisanteries jetables et les évidences.
  • Questions numériques / à réponse courte — adaptées aux sujets quantitatifs : l'apprenant calcule et vérifie avec la réponse et sa solution détaillée.
  • Questions ouvertes / de dérivation — demandent à l'apprenant de raisonner ou de déduire, puis révèlent une réponse modèle qu'il évalue lui-même. Utilisez-les pour les difficultés plus élevées.

Pour chaque question, rédigez :

  1. Un énoncé clair. Utilisez LaTeX pour les mathématiques (voir la section format) — en ligne avec \( ... \) ou en affichage avec \[ ... \].
  2. Une explication simplifiée de la bonne réponse — le cœur de la compétence. Expliquez-la comme le ferait un bon tuteur à une personne du niveau choisi : simple, directe, en partant de ce qu'elle sait. Simplifiez le langage, pas l'exactitude.
  3. Lorsque le sujet est quantitatif, une dérivation : une liste ordonnée d'étapes allant des premiers principes au résultat, chaque étape étant une courte ligne de raisonnement accompagnée de son équation. Le HTML révèle ces blocs un par un pour que l'apprenant puisse essayer avant de regarder.
  4. Une ou plusieurs citations, chacune avec un libellé et (idéalement) une URL/DOI.

Calibrez la profondeur en fonction de la difficulté : au niveau Fondamental, vous pouvez sauter la dérivation et donner une analogie intuitive ; au niveau Doctorat, la dérivation est rigoureuse et la citation est une source primaire.

Construisez le HTML interactif

Utilisez le modèle fourni plutôt que de créer une page à la main à chaque fois — il gère déjà le rendu MathJax, la vérification des réponses, le suivi du score, la progression, les dérivations repliables et les liens de citation, et il a une apparence soignée. Lisez references/html-format.md pour la procédure de construction complète et le schéma exact des données QUIZ, puis remplissez le bloc de données du modèle avec vos questions. Ne réécrivez pas le CSS/JS du modèle à partir de zéro ; vous ne fournissez que le contenu.

La page finale doit permettre à l'apprenant de : lire une question avec des équations correctement rendues, choisir ou révéler une réponse, obtenir un retour immédiat (bon/mauvais), dérouler l'explication et la dérivation étape par étape, suivre les liens de citation, et voir un score en cours avec un résumé à la fin. Un badge de difficulté se trouve en haut pour qu'il sache ce qu'il fait.

Livraison

Enregistrez le quiz terminé sous forme d'un seul fichier .html dans le dossier de sortie des compétences préféré de l'utilisateur (selon les conventions du projet ou de la mémoire), nommez-le de manière descriptive (quiz-<sujet>-<difficulté>.html), et présentez-le à l'utilisateur afin qu'il puisse l'ouvrir directement. Gardez votre message de clôture court — le quiz parle de lui-même. Proposez d'ajuster la difficulté, d'ajouter des questions ou de préciser le sujet comme suite naturelle.

Signalement des hypothèses

Si vous avez dû faire un choix qui affecte l'exactitude — hypothèse sur une convention (signe, unités, notation), choix d'un côté d'un point réellement débattu, ou impossibilité de vérifier complètement une source — mentionnez-le brièvement lorsque vous remettez le quiz, afin que l'utilisateur puisse le tester. Les hypothèses silencieuses dans un outil d'étude se propagent dans ce que quelqu'un apprend.

Skills associés