Die zwei Pflichtentscheidungen, die jede Kurs-Generierung steuern — bevor auch nur eine Zeile HTML entsteht
Der Skill erzeugt nicht einen Kurs für alle, sondern einen eigenen Kurs pro Zielgruppe. Jede Gruppe hat andere Fragen an den Code — und bekommt genau die Antworten, die sie braucht. Tiefe, Tonalität und Fokus unterscheiden sich grundlegend.
🏷️ Custom-Zielgruppe: Keine der drei passt? Dann definiere eine eigene Zielgruppe. Beschreibe, wer die Leser sind und was sie wissen wollen — der Skill erstellt einen maßgeschneiderten Kurs mit passender Tiefe und Sprache. Beispiel: "QA-Ingenieure, die das Testsystem verstehen wollen".
Du kannst mehrere Zielgruppen gleichzeitig auswählen. Der Skill erzeugt dann für jede Gruppe einen separaten Satz an HTML-Dateien — im selben Output-Ordner, aber mit unterschiedlichen Dateinamen.
Die Namensregel ist einfach: Die erste (allgemeinste) Zielgruppe bekommt index_de.html, alle weiteren bekommen ein Suffix. Die Reihenfolge lautet: Anwender > Entscheider > Entwickler > Custom.
Warum separate Dateien? Jede Zielgruppe hat ein eigenes Curriculum, eigene Helpfulness-Scores und einen eigenen Navigationsbaum. Eine Vermischung würde den Fokus verwässern — deshalb generiert der Skill lieber drei schlanke Kurse als einen überladenen.
Die zweite Pflichtfrage: Wie sollen die Dateien genutzt werden? Die Antwort bestimmt, ob der Skill Header, Footer und externe Links in die HTML-Dateien einbaut — oder sie als autarke Einzeldateien ausliefert.
| Eigenschaft | Standalone | Eingebettet |
|---|---|---|
| Einsatzzweck | Teilen per E-Mail, Slack, Download | Teil einer Website oder Dokumentation |
| Header-Links | Keine | GitHub-Repo, Docs-Link |
| Footer | Keiner | Impressum, Datenschutz, Copyright |
| Externe Links | Keine externen Verweise | Öffnen in neuem Tab (target="_blank") |
| Offline-fähig | Ja — komplett eigenständig | Ja, aber Links setzen Netzwerk voraus |
| Zusätzliche Angaben | Keine | GitHub-URL, Impressum-URL (Pflicht) |
Welchen Modus solltest du wählen, wenn du den Kurs per Slack teilen willst?
Wählst du den eingebetteten Modus, fragt der Skill nach ein paar zusätzlichen Informationen. Zwei davon sind Pflicht, zwei optional — aber alle verbessern das Ergebnis.
Sprache musst du nicht wählen — jeder Kurs wird automatisch in Deutsch und Englisch generiert. Immer. Ohne Ausnahme. Es gibt keine „nur Deutsch"- oder „nur Englisch"-Option.
Wie die Verlinkung funktioniert: Jede Datei enthält ein Flaggen-Icon in der Navigation, das zur Sprachversion verlinkt. Die Benennung folgt einem festen Schema:
Warum immer zweisprachig? Software-Teams sind international. Ein Kurs, der nur in einer Sprache existiert, schließt immer jemanden aus. Deshalb ist Zweisprachigkeit keine Option — sie ist Standard.