Communitygithub.com

study-site

À utiliser pour créer toute page d'étude, page de notes de chapitre, fiche de révision ou d'examen, ou index de cours — à partir de diapositives, PDF, annales, fiches d'exercices ou simplement d'un nom de sujet.

Qu'est-ce que study-site ?

Cette compétence permet de construire des pages d'étude HTML autonomes, interactives et prêtes à être publiées sous forme d'artefacts (ou de fichiers `.html` lorsque les artefacts ne sont pas disponibles). Elle est conçue pour les développeurs et les power users d'agents IA qui souhaitent générer du contenu pédagogique structuré et de haute qualité, que ce soit pour un cours universitaire, une révision d'examen, ou un simple sujet d'étude. La compétence prend en charge plusieurs plateformes (Claude Code, Cursor, Codex, etc.) en produisant un seul fichier HTML basé sur un template prédéfini (`assets/template.html`) qui intègre des fonctionnalités comme la recherche, le suivi de progression, le mode examen, les flashcards et les diagrammes SVG. Elle suit une méthodologie rigoureuse : poser des questions ciblées pour comprendre le contexte (cours ou non, index de rattachement), rassembler et corriger silencieusement le matériel source (diapositives, annales, exercices), puis organiser le contenu par topics logiques avec une structure d'enseignement cohérente (explication → diagramme → exemple → questions). La compétence s'adapte automatiquement au type de matière (théorique, systèmes, langages, mathématiques, descriptive) et applique des règles de design minimalistes et accessibles. Elle garantit qu'aucune question n'est laissée sans réponse et que chaque diagramme est expliqué, ce qui en fait un outil idéal pour la création rapide de supports d'étude fiables et complets.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ranjit-choudhary/claude-skills-ranjit/tree/HEAD/study-site

Demander à votre IA préférée

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

Documentation

Study Site

Créez des pages d'étude HTML interactives, autonomes, publiées sous forme d'artefacts (ou enregistrées sous forme de fichiers .html si les artefacts ne sont pas disponibles). Chaque page part de assets/template.html, afin que les fonctionnalités permanentes ne soient jamais oubliées.

0. Paramètres — modifiez-les pour vous

ParamètreValeur
URL de l'index principal (hub qui lie tous les cours)none — définissez l'URL de votre hub, ou laissez none pour ignorer les mises à jour de l'index
Thème par défautlight (un bouton de basculement sombre est toujours inclus)
Navigation entre chapitresLien de retour vers l'index du cours uniquement — pas de liens chapitre précédent/suivant
Style des fiches d'indexMinimal : icône, code du cours, nom du cours — pas de statistiques

1. Demander d'abord (un tour de questions)

Ne demandez que ce qui n'est pas déjà clair dans la demande :

  1. Est-ce pour un cours ? Si oui : quel cours, quel chapitre ou bloc. Une page de cours reçoit le mode examen et les outils de révision en plus des fonctionnalités standard ; une page hors cours (sujet général, explication ponctuelle) les ignore.
  2. Où doit-elle être listée ? Directement sur l'index principal, à l'intérieur d'un index d'étude de cours (lequel), ou nulle part. Ignorez cette question si le paramètre de l'index principal est none.
  3. Si l'URL de l'index d'étude du cours n'est pas connue, demandez-la — le lien de retour de la page en a besoin.

Si l'utilisateur a enregistré des notes sur la façon dont il souhaite qu'un cours soit enseigné (mémoire, instructions de projet, messages précédents), lisez-les et suivez-les plutôt que les valeurs par défaut ci-dessous.

2. Rassembler le matériel avant de construire

  • Lisez entièrement chaque fichier joint : diapositives, notes, annales, fiches d'exercices.
  • Collectez les questions des années précédentes (PYQ) et les questions d'exercices appartenant à chaque sujet.
  • Corrigez silencieusement les erreurs dans le matériel source ; ne les soulignez que si on vous le demande.
  • Ce n'est qu'ensuite que vous planifiez la liste des sujets : une <section class="topic"> par sujet logique, suffisamment petite pour être terminée en une seule séance.

3. Règles d'enseignement (toutes matières)

  • Ne supposez aucune connaissance préalable. Partez des bases, définissez chaque terme lors de sa première utilisation, développez plutôt que de condenser.
  • Ordre à l'intérieur de chaque sujet : explication → son diagramme immédiatement après → explication du diagramme → exemple concret → questions PYQ/exercices → QCM d'entraînement. Ne regroupez jamais les diagrammes à la fin.
  • Chaque diagramme reçoit une explication. Ne livrez jamais un diagramme nu.
  • Marquez les points importants pour l'examen avec .callout.imp et les pièges courants avec .callout.mistake.
  • Questions : rédigez chaque question en entier avant sa solution, jamais condensée. Répondez à chaque question ; n'en laissez aucune sans réponse. Étiquetez les PYQ avec la source, l'année et les points (par ex. PYQ 2024 Midsem · 5M).
  • Au moins 3 QCM d'entraînement par sujet, avec des distracteurs plausibles et une explication .why.
  • Les diagrammes sont en SVG intégré, jamais en ASCII. Utilisez un .stepper (un figure.fig.step par état) pour tout ce qui évolue étape par étape.
  • Pas de planning d'étude ou de plans journaliers sauf si demandé.

4. Adapter par matière

Type de matièreAccent
Théorie / preuves (théorie du calcul, maths discrètes, algorithmes)Diagrammes d'états pour chaque automate ; steppers qui tracent les chaînes d'entrée ; modèles de preuve (pompage, réductions, induction) sous forme d'étapes à remplir ; nombreux petits exemples
Systèmes (systèmes d'exploitation, architecture des ordinateurs, réseaux)Visuel en premier ; steppers pour les pipelines, diagrammes de Gantt d'ordonnancement, remplacement de pages, accès cache ; exercices numériques résolus étape par étape ; exercices de fin de chapitre de manuels
Langages / notation formelle (langages de programmation, compilateurs)BNF/EBNF, arbres d'analyse et grammaires attribuées sous forme d'arbres SVG propres ; regex construite pièce par pièce ; questions d'exercices résolues en ligne
Mathématiques lourdes (apprentissage automatique, statistiques, signaux)Intuition d'abord, puis dérivation ligne par ligne avec chaque étape justifiée ; graphiques en SVG ; exercices résolus de manuels
Descriptif (biologie, management, sciences humaines)Piloté par les annales : regrouper les PYQ par thème, réponses modèles à la longueur de l'examen, organigrammes et tableaux de comparaison pour les processus

Choisissez la ligne la plus proche pour une matière non listée. Les notes de cours de l'utilisateur prévalent sur ce tableau.

5. Fonctionnalités de la page (intégrées au template)

FonctionnalitéComment ça fonctionneVotre tâche
Thème clair + basculement sombreClair par défaut ; 🌙 bascule ; choix mémoriséUtilisez uniquement les variables CSS — pas de couleurs codées en dur
Restauration du défilementPosition sauvegardée et restaurée à la réouvertureRien
Suivi de progression"Marquer comme fait" par sujet, barre de progression, ✓ dans le sommaireid unique sur chaque section de sujet
RechercheFiltre les sujets et met en évidence les résultatsRien
Copie d'imageBouton survol sur chaque figure.fig qui copie un PNG (toujours visible sur tactile)Encadrez chaque diagramme ou image dans figure.fig
Adapté aux mobilesResponsive ; les tableaux défilent horizontalementGardez les SVG basés sur viewBox ; pas de largeurs fixes
QCM d'entraînementRetour instantané ; réponses mémoriséesdata-answer = index basé sur 0 de la bonne option
Afficher la réponsedetails.answerUtilisez pour toute solution longue
Lien de retourL'en-tête renvoie vers l'index d'étude du coursRemplissez {{COURSE_INDEX_URL}}
Pages de cours uniquement : outils de révisionAide-mémoire (.cheatsheet) + flashcards (.flashdeck)Résumé d'une page des formules, définitions, diagrammes clés ; 10+ flashcards
Pages de cours uniquement : mode examenFlouté jusqu'au démarrage ; minuteur ; QCM notés à la soumission ; réponses modèles révéléesMélangez les QCM (data-marks) et les questions longues stylisées d'après les annales du cours ; définissez data-minutes

La progression et les scores vivent dans le navigateur du lecteur, par page — une page d'index ne peut pas afficher la progression des chapitres, et rien n'est synchronisé entre les appareils.

6. Règles de design

  • Minimal et calme. Police avec empattement pour la lecture longue, sans empattement pour l'interface utilisateur. Largeur du contenu ~820px.
  • Évitez l'IA générique : pas de dégradés violets, bannières héros, mises en page tout-centré, Inter, ou confettis d'emoji.
  • La couleur porte du sens : bleu = information, or = important pour l'examen, rouge = erreur, vert = correct/fait.
  • Diagrammes SVG : étiquetez tout ; utilisez var(--text), var(--accent), etc. pour les traits et les remplissages ; texte ≥12px à la largeur mobile.

7. Pages d'index d'étude de cours

Pour un index ou hub de cours : fiches minimales (voir paramètres), même en-tête (recherche + basculement de thème), restauration du défilement, clair par défaut.

8. Construire, publier, vérifier

  1. Copiez assets/template.html, remplissez les {{placeholders}}, supprimez les blocs réservés aux cours pour les pages hors cours (ou décommentez-les pour les pages de cours).
  2. Publiez sous forme d'artefact (ou enregistrez le .html). Montrez-le d'abord ; vérifiez ensuite.
  3. Vérifiez sur ordinateur et à une largeur d'environ 390px, dans les deux thèmes : chaque figure a un bouton de copie, chaque QCM a un data-answer correct, chaque question a une réponse, aucun {{placeholders}} ne subsiste.
  4. Ajoutez le lien de la page à l'index principal ou du cours comme choisi à l'étape 1. Ne reconcevez pas l'index.

Skills associés