mcq-generator

name	MCQ Generator
description	AI-assisted generation of MCQs (multiple-choice questionnaires) with export to Moodle (GIFT, XML), Wooclap (Excel), Kahoot!, and Word. Supports light MCQs (gamified) and in-depth MCQs (evaluative), with single-answer and multiple-answer formats.
metadata	{"author":"Christophe Quézel-Ambrunaz","license":"agpl-3.0","version":"2026-04-10"}

QCM Generator - Version 3.0

Vue d'ensemble

Cette skill guide la création de QCM de qualité académique avec recherche documentaire systématique, validation factuelle rigoureuse, construction méthodique des distracteurs, et génération de fichiers prêts pour divers usages pédagogiques.

Nouveautés V.3 :

• Dichotomie QCM léger (ludique, sans feedbacks) / QCM approfondi (évaluatif, avec feedbacks)
• Randomisation de la position des bonnes réponses (visible dès la prévisualisation)
• Échelle de niveau adaptée : Primaire, Collège, Lycée, Licence, Master
• Export Kahoot! (.xlsx) pour QCM légers
• Export Word (.docx) avec feuille questions + grille correction + corrigé détaillé
• Précision : XML Moodle importable directement dans Wooclap

Héritées de V.2 :

• Système de pénalités configurable pour réponses incorrectes
• Méthodologie formalisée de construction des distracteurs (5/6 conceptuels, 1/6 linguistiques)
• Progression de difficulté croissante obligatoire
• Protocole de versionnement pour modifications itératives
• Guidelines détaillées pour feedbacks pédagogiques de qualité

Workflow en 5 phases

Phase 1 : Collecte des informations

PREMIÈRE QUESTION PRIORITAIRE : Lire references/usage_type_choice.md et demander à l'utilisateur de choisir entre :

• QCM Léger (ludique, révision, Kahoot!/Wooclap) : Sans feedbacks, contraintes longueur strictes
• QCM Approfondi (évaluatif, formatif) : Avec feedbacks détaillés, longueur libre

Ce choix conditionne toute la suite du processus.

---

Puis vérifier systématiquement que l'utilisateur a fourni :

1. Nombre de questions
2. Nombre de réponses par question (recommandation : 4-6)
3. Type de réponses : choix unique ou réponses multiples
4. Système de pénalités : Points négatifs pour réponses incorrectes ? Si oui, quelle pénalité ?
5. Thématique/sujet précis
6. Niveau : Primaire, Collège, Lycée, Licence, ou Master (accepter précisions : "Licence 3", "Master 2", etc.)
7. Objectif pédagogique (vérification connaissances / évaluation compréhension / réflexion)

Toujours demander si l'utilisateur souhaite charger des documents de référence.

Si informations manquantes, lire references/collect_information_missing.md et demander les informations.

Phase 2 : Recherche documentaire

Principe absolu : Exactitude factuelle prime sur tout.

Recherche web OBLIGATOIRE pour :

• Droit (législation, jurisprudence, doctrine) - Priorité Légifrance pour droit français
• Sciences et techniques (évolutions récentes)
• Politique, médecine, économie, tout domaine où la fraîcheur importe

Sources : Privilégier sources académiques, institutionnelles, gouvernementales.

Validation : Croiser au moins 2 sources indépendantes pour chaque fait important.

Phase 3 : Génération du document de prévisualisation

LECTURE CONDITIONNELLE selon type de QCM :

Si QCM LÉGER :

• Lire obligatoirement references/constraints_light_mcq.md (contraintes 95/60 caractères)
• NE PAS générer de feedbacks
• Focus : questions factuelles courtes et percutantes
• Régénérer automatiquement si dépassement de contraintes (max 2 tentatives)

Si QCM APPROFONDI :

• Lire obligatoirement references/feedback_guidelines.md
• Générer feedbacks détaillés pour chaque réponse selon guidelines
• Longueur libre pour énoncés et réponses

DANS TOUS LES CAS, lire obligatoirement :

• references/distractor_methodology.md pour construction des distracteurs
• references/difficulty_progression.md pour organisation des questions

---

Créer un document Markdown structuré avec pour chaque question :

Principes de rédaction :

• Énoncés clairs, univoques, sans ambiguïté
• Distracteurs : 5/6 conceptuels (erreurs de compréhension), 1/6 linguistiques (mots proches)
• Feedbacks apportant valeur pédagogique selon guidelines (si approfondi)
• Longueur homogène des réponses
• Ordre des questions : Progression stricte de la plus simple à la plus difficile

RANDOMISATION OBLIGATOIRE :

• Mélanger l'ordre des réponses pour chaque question (algorithme Fisher-Yates)
• Appliquer la randomisation DÈS la prévisualisation
• Marquer visuellement les bonnes réponses : ✅ [Texte de la réponse]
• Identifier clairement quelle(s) position(s) occupe(nt) la/les bonne(s) réponse(s)

Structure par question :

1. Numéro et énoncé
2. Réponses (randomisées, avec ✅ pour les correctes)
3. Feedbacks détaillés pour chaque option (si approfondi uniquement)
4. Justification du niveau de difficulté
5. Sources documentaires consultées

Phase 4 : Révision et validation

AVERTISSEMENT OBLIGATOIRE : Lire references/revision_warning.md et rappeler que :

• Claude peut faire des erreurs
• Révision humaine indispensable
• Possibilité de modifications

Si l'utilisateur demande des modifications :

• Lire references/versioning_protocol.md
• Documenter les changements dans un changelog
• Numéroter les versions (X.Y)
• Générer une comparaison avant/après si demandé

Puis proposer choix du format en lisant references/output_format_choice.md

Phase 5 : Génération des fichiers

Selon le format choisi et le type de QCM, lire les spécifications dans references/ :

Formats disponibles pour QCM LÉGER :

• Kahoot! : references/format_kahoot.md - Format natif optimisé
• Wooclap Excel : references/format_wooclap.md
• GIFT : references/format_gift.md (sans feedbacks)
• XML Moodle : references/format_xml_moodle.md (sans feedbacks)

Formats disponibles pour QCM APPROFONDI :

• GIFT : references/format_gift.md (avec feedbacks)
• XML Moodle : references/format_xml_moodle.md (avec feedbacks)
  • IMPORTANT : Les fichiers XML Moodle peuvent être importés directement dans Wooclap via "Importer un événement"
• Wooclap Excel : references/format_wooclap.md (feedbacks à ajouter manuellement après import)
• Word : references/format_word.md (feuille questions + grille correction + corrigé détaillé)

Puis fournir instructions d'utilisation : references/usage_[format].md

Note sur Wooclap :

• Format Excel disponible pour léger ET approfondi
• Pour QCM approfondis, privilégier XML Moodle importable dans Wooclap (préserve mieux les feedbacks)

Limitations

Types NON supportés : Questions ouvertes, réponse courte, appariement, numériques pures, texte à trous, classement. Si demandé : references/unsupported_question_type.md

Contenu problématique : Refus catégorique si factuellement faux, discriminatoire, biaisé, ou nuisible. Si détecté : references/refuse_problematic_content.md