Communitygithub.com

study-site

Erstelle interaktive, einzelne HTML-Studienseiten als Artefakte – für Kursseiten, Kapitelnotizen, Prüfungsvorbereitung oder Studienübersichten aus Folien, PDFs, Altklausuren, Übungsblättern oder nur einem Thema.

Was ist study-site?

Die **Study Site**-Fähigkeit erstellt interaktive, eigenständige HTML-Studienseiten, die als Artefakte (z. B. in Claude Code, Cursor, Codex) veröffentlicht oder als `.html`-Dateien gespeichert werden können. Sie eignet sich für Kursseiten mit Prüfungsmodus und Wiederholungswerkzeugen sowie für allgemeine Themenseiten. Jede Seite basiert auf einer Vorlage (`assets/template.html`) und enthält automatisch Funktionen wie Hell-/Dunkel-Modus, Scrollposition speichern, Fortschrittsverfolgung, Suche, Bild-Kopieren und Übungs-MCQs. Der Workflow besteht aus: 1) Fragen zum Kurs und zur Einordnung, 2) vollständigem Lesen aller beigefügten Materialien (Folien, Notizen, Altklausuren), 3) Erstellung der Inhalte nach strengen didaktischen Regeln (kein Vorwissen angenommen, Diagramme immer erklärt, Prüfungsrelevantes markiert), 4) Anpassung an den Fachbereich (z. B. Theorie, Systeme, Mathematik), 5) Einbau der Seitenfunktionen, 6) Designvorgaben (minimal, ruhig, bedeutungsvolle Farben) und 7) Veröffentlichung und Prüfung. Die Fähigkeit unterstützt sowohl Kursindexseiten (mit Karteikarten) als auch eigenständige Seiten und legt Wert auf Klarheit, Vollständigkeit und keine generischen KI-Ausgaben.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Study Site (deutsch)

Erstelle interaktive, einzelne HTML-Studienseiten, die als Artefakte veröffentlicht (oder als .html-Dateien gespeichert) werden. Jede Seite beginnt mit assets/template.html, sodass die Standardfunktionen nie vergessen werden.

0. Einstellungen — für dich anpassen

EinstellungWert
Master-Index-URL (Hub, der alle Kurse verlinkt)none — setze die URL deines Hubs oder lasse none stehen, um Index-Updates zu überspringen
Standard-Themelight (ein Dunkelmodus-Umschalter ist immer enthalten)
KapitelnavigationZurück-Link nur zum Kursindex – keine vorherigen/nächsten Kapitel-Links
Karteikarten-StilMinimal: Icon, Kurscode, Kursname – keine Statistiken

1. Zuerst fragen (ein Frageround)

Frage nur das, was aus der Anfrage nicht bereits klar ist:

  1. Ist dies für einen Kurs? Wenn ja: welcher Kurs, welches Kapitel oder welcher Abschnitt. Eine Kursseite erhält Prüfungsmodus und Wiederholungswerkzeuge zusätzlich zu den Standardfunktionen; eine Nicht-Kursseite (allgemeines Thema, einmalige Erklärung) überspringt diese.
  2. Wo soll es aufgeführt werden? Direkt im Master-Index, innerhalb eines Kurs-Studienindex (welcher) oder nirgendwo. Überspringe diese Frage, wenn die Master-Index-Einstellung none ist.
  3. Wenn die URL des Kurs-Studienindex nicht bekannt ist, frage danach – der Zurück-Link der Seite benötigt sie.

Wenn der Benutzer Notizen dazu gespeichert hat, wie ein Kurs unterrichtet werden soll (Erinnerungen, Projektanweisungen, frühere Nachrichten), lies sie und befolge sie vor den untenstehenden Standardeinstellungen.

2. Material vor dem Bau sammeln

  • Lies jede beigefügte Datei vollständig: Folien, Notizen, Altklausuren, Übungsblätter.
  • Sammle die Altklausurfragen (PYQs) und Übungsfragen, die zu jedem Thema gehören.
  • Korrigiere stillschweigend Fehler im Quellmaterial; weise nicht darauf hin, es sei denn, du wirst gefragt.
  • Erstelle erst dann die Themenliste: ein <section class="topic"> pro logischem Thema, klein genug, um es in einer Sitzung zu schaffen.

3. Lehrregeln (alle Fächer)

  • Gehe von keinem Vorwissen aus. Baue von den Grundlagen auf, definiere jeden Begriff bei der ersten Verwendung, erkläre lieber ausführlich als zu komprimieren.
  • Reihenfolge innerhalb jedes Themas: Erklärung → unmittelbar danach das dazugehörige Diagramm → Erklärung des Diagramms → durchgerechnetes Beispiel → PYQs/Übungsfragen → Übungs-MCQs. Nie Diagramme am Ende bündeln.
  • Jedes Diagramm erhält eine Erklärung. Liefere niemals ein nacktes Diagramm aus.
  • Markiere prüfungsrelevante Punkte mit .callout.imp und häufige Fallen mit .callout.mistake.
  • Fragen: Schreibe jede Frage vollständig aus, bevor du die Lösung gibst, niemals verkürzt. Beantworte jede Frage; lasse keine unbeantwortet. Kennzeichne PYQs mit Quelle, Jahr und Punkten (z. B. PYQ 2024 Zwischenklausur · 5P).
  • Mindestens 3 Übungs-MCQs pro Thema, mit plausiblen Ablenkern und einer .why-Erklärung.
  • Diagramme sind Inline-SVG, niemals ASCII. Verwende einen .stepper (ein figure.fig.step pro Zustand) für alles, das sich schrittweise entwickelt.
  • Keine Lernpläne oder Tagespläne, es sei denn, sie werden verlangt.

4. Anpassung nach Fach

FachtypSchwerpunkt
Theorie / Beweise (Theoretische Informatik, Diskrete Mathematik, Algorithmen)Zustandsdiagramme für jeden Automaten; Stepper, die Eingabezeichenfolgen verfolgen; Beweisschablonen (Pumping-Lemma, Reduktionen, Induktion) als auszufüllende Schritte; viele kleine Beispiele
Systeme (Betriebssysteme, Computerarchitektur, Netzwerke)Visuell zuerst; Stepper für Pipelines, Scheduling-Gantt-Diagramme, Seitenersetzung, Cache-Zugriffe; Schritt-für-Schritt-Numerik; Übungen am Kapitelende
Sprachen / formale Notation (Programmiersprachen, Compiler)BNF/EBNF, Ableitungsbäume und attributierte Grammatiken als saubere SVG-Bäume; Regex schrittweise aufgebaut; Übungsfragen direkt gelöst
Mathematisch lastig (Maschinelles Lernen, Statistik, Signale)Intuition zuerst, dann die Herleitung Zeile für Zeile mit begründetem Schritt; Diagramme in SVG; gelöste Lehrbuchübungen
Beschreibend (Biologie, Management, Geisteswissenschaften)Altklausur-getrieben: gruppiere PYQs nach Thema, Musterantworten in Prüfungslänge, Flussdiagramme und Vergleichstabellen für Prozesse

Wähle die nächstliegende Zeile für ein nicht aufgeführtes Fach. Die eigenen Kursnotizen des Benutzers überschreiben diese Tabelle.

5. Seitenfunktionen (in der Vorlage eingebaut)

FunktionFunktionsweiseDeine Aufgabe
Helles Theme + Dunkelmodus-UmschalterStandard hell; 🌙 schaltet um; Auswahl wird gemerktVerwende nur die CSS-Variablen – keine fest codierten Farben
Scrollposition wiederherstellenPosition wird gespeichert und beim erneuten Öffnen wiederhergestelltNichts
Fortschrittsverfolgung„Als erledigt markieren" pro Thema, Fortschrittsbalken, ✓ im InhaltsverzeichnisEindeutige id für jeden Themenabschnitt
SucheFiltert Themen und hebt Treffer hervorNichts
Bild kopierenSchwebeschaltfläche auf jedem figure.fig kopiert ein PNG (auf Touch immer sichtbar)Wickle jedes Diagramm oder Bild in figure.fig
MobilfreundlichResponsive; Tabellen scrollen seitlichSVG viewBox-basiert; keine festen Breiten
Übungs-MCQsSofortiges Feedback; Antworten werden gemerktdata-answer = 0-basierter Index der richtigen Option
Antwort anzeigendetails.answerVerwenden für jede ausführliche Lösung
Zurück-LinkHeader verlinkt zum Kurs-StudienindexFülle {{COURSE_INDEX_URL}} aus
Nur für Kursseiten: WiederholungswerkzeugeSpickzettel (.cheatsheet) + Karteikarten (.flashdeck)Einseitige Zusammenfassung von Formeln, Definitionen, Schlüsseldiagrammen; 10+ Karteikarten
Nur für Kursseiten: PrüfungsmodusBis zum Start unscharf; Timer; MCQs werden beim Absenden bewertet; Musterlösungen werden angezeigtMische MCQs (data-marks) und lange Fragen im Stil der Altklausuren des Kurses; setze data-minutes

Fortschritt und Punktzahlen bleiben im Browser des Betrachters, pro Seite – eine Indexseite kann keinen Kapitelfortschritt anzeigen, und nichts wird geräteübergreifend synchronisiert.

6. Gestaltungsregeln

  • Minimal und ruhig. Serif-Schriftart für längeres Lesen, serifenlose Schrift für die Benutzeroberfläche. Inhaltsbreite ~820px.
  • Vermeide KI-Geschwurbel: keine violetten Verläufe, Heldenbanner, alles-zentrierte Layouts, Inter oder Emoji-Konfetti.
  • Farbe trägt Bedeutung: Blau = Info, Gold = prüfungsrelevant, Rot = Fehler, Grün = richtig/erledigt.
  • SVG-Diagramme: alles beschriften; var(--text), var(--accent) usw. für Striche und Füllungen verwenden; Text ≥12px bei mobiler Breite.

7. Kurs-Studienindex-Seiten

Für einen Kursindex oder Hub: minimale Karten (siehe Einstellungen), gleicher Header (Suche + Theme-Umschalter), Scrollposition wiederherstellen, helles Standard-Theme.

8. Bauen, veröffentlichen, prüfen

  1. Kopiere assets/template.html, fülle die {{placeholders}} aus, lösche die kurs-exklusiven Blöcke für Nicht-Kursseiten (oder kommentiere sie für Kursseiten ein).
  2. Veröffentliche als Artefakt (oder speichere die .html). Zeige es zuerst; überprüfe danach.
  3. Prüfe auf Desktop und ~390px Breite, in beiden Themes: jede Abbildung hat eine Kopier-Schaltfläche, jeder MCQ hat ein korrektes data-answer, jede Frage hat eine Antwort, keine {{placeholders}} sind mehr vorhanden.
  4. Füge den Seitenlink zum Master- oder Kursindex hinzu, wie in Schritt 1 gewählt. Gestalte den Index nicht neu.

Verwandte Skills