Den Skill starten

So gibst du ein Projekt an und startest die automatische Kurs-Generierung

Auf dieser Seite

01Projekt angeben 02Die zwei Pflichtfragen 03Was dann passiert 04Tipps für beste Ergebnisse

01

Projekt angeben

Der erste Schritt: Sag dem Skill, welchen Code er analysieren soll. Es gibt drei Wege, und der Skill erkennt automatisch, welchen du nutzt.

📁

Lokaler Ordner

Gib einen Pfad auf deinem Rechner an. Der Skill liest alle relevanten Dateien im Verzeichnis.

/Users/mein-name/projekte/mein-tool

🔗

GitHub-URL

Teile eine GitHub-Repository-URL. Der Skill klont das Repo und analysiert den Code.

github.com/org/my-project

📂

Aktuelles Projekt

Wenn du den Skill direkt im Projektordner startest, sag einfach "nutze das aktuelle Projekt".

"Nimm dieses Projekt hier"

Gut zu wissen: Der Skill braucht keinen speziellen Befehl. Schreibe einfach natürlich, was du möchtest — z.B. "Erstelle einen Lernkurs für /Users/max/mein-tool" oder "Analysiere https://github.com/org/project". Die Erkennung passiert automatisch.

02

Die zwei Pflichtfragen

Bevor auch nur eine Zeile HTML erzeugt wird, stellt der Skill zwei Fragen. Es gibt keine Standardwerte — beide müssen beantwortet werden. Das ist Absicht, denn die Antworten bestimmen alles Weitere.

Skill

Für welche Zielgruppen soll der Kurs erstellt werden?

Wähle eine oder mehrere:
👤 Anwender — Nutzer der Software
🔧 Entwickler — technische Mitwirkende
📊 Entscheider — Manager & Stakeholder
🏷️ Custom — eigene Zielgruppe definieren

Du

Anwender und Entwickler

Skill

Wie sollen die HTML-Dateien genutzt werden?

Standalone — zum Teilen per E-Mail/Slack
Eingebettet — Teil einer Website (mit Impressum, GitHub-Link, Navigation)

Du

Eingebettet

Skill

Verstanden. Bitte gib mir noch die URLs für:
• GitHub-Repository
• Impressum-Seite

Dann lege ich los.

🎯

Frage 1: Zielgruppen

Multi-Select aus den verfügbaren Zielgruppen. Jede ausgewählte Gruppe bekommt einen eigenen, vollständigen Kurs mit eigenen HTML-Dateien.

Pflicht

📄

Frage 2: Integrationsmodus

Standalone: Dateien zum Teilen, ohne Rahmen. Eingebettet: Mit Header, Footer, Impressum und Links — bereit für eine Website.

Pflicht

03

Was dann passiert

Sobald du beide Fragen beantwortet hast, startet der Skill einen siebenstufigen Prozess. Du musst nichts weiter tun — der Skill arbeitet die Phasen automatisch ab und erzeugt am Ende fertige HTML-Dateien.

1

Codebase analysieren Der Skill liest alle relevanten Dateien, erkennt Sprachen, Frameworks und Architektur.

2

Curriculum planen Pro Zielgruppe wird ein Lehrplan erstellt: Welche Themen, in welcher Reihenfolge, auf welcher Ebene.

3

Helpfulness-Scores berechnen Für jedes Thema wird bewertet, ob eine Vertiefungsseite für die jeweilige Zielgruppe sinnvoll ist (Score 1-10).

4

Überblicksseiten generieren Die Hauptseiten (eine pro Zielgruppe, je DE + EN) werden erstellt — mit allen Modulen und Visualisierungen.

5

Vertiefungsseiten generieren Themen mit hohem Helpfulness-Score bekommen eigene Seiten mit mehr Detail, Beispielen und Quizzes.

6

Detailseiten generieren Für besonders tiefe Themen (vor allem bei Entwicklern) werden weitere Ebenen mit Code-Walkthroughs erstellt.

7

Verlinkung und Abschluss Alle Seiten werden verlinkt, Sprachversionen verbunden und die finale Dateistruktur im Output-Ordner abgelegt.

04

Tipps für beste Ergebnisse

📂

Alle Dateien bereitstellen

Gib dem Skill Zugriff auf alle relevanten Dateien. Je mehr Kontext, desto bessere Erklärungen. Konfigurationsdateien, README, Tests — alles hilft.

👥

Alle Zielgruppen sofort nennen

Benenne alle Zielgruppen beim Start. Nachträgliches Hinzufügen bedeutet, dass die Curricula und Scores neu berechnet werden müssen.

🔗

URLs für eingebetteten Modus

Wenn du "Eingebettet" wählst, halte deine URLs bereit: GitHub-Repository, Impressum-Seite und ggf. weitere Navigationslinks.

⚡

Geduld bei großen Projekten

Bei umfangreichen Codebases kann die Generierung mehrere Minuten dauern. Der Skill arbeitet gründlich — Qualität braucht Zeit.

✏️ Kurz getestet

Was ist das Minimum, das der Skill zum Starten braucht?

Nur den Pfad zum Code — den Rest entscheidet der Skill

Code-Quelle + Zielgruppen + Integrationsmodus

Code-Quelle + Zielgruppen + Integrationsmodus + eine Gliederung

Nur die Zielgruppen — den Code findet der Skill selbst

Weitere Vertiefungsseiten für Anwender

01 Den Skill starten 02 Zielgruppen & Integration 03 Das Level-System 04 Tiefenprofile