# IGNW SkillForge – Anleitung: Wie geht das, was beachten, wie anpassen

Diese Anleitung erklärt, wie Sie die in der Bibliothek bereitgestellten Muster-Skills in der **Langdock**-Plattform einsetzen, an Ihre IGNW-Realität anpassen und konsistent im Workspace verankern. Sie folgt dem in der Langdock-Dokumentation [1] [2] beschriebenen SKILL.md-Format und Best-Practice-Rahmen.

## Was ist ein Skill?

Ein Skill in Langdock ist ein wiederverwendbares Set von Anweisungen, das im Chat automatisch aktiviert wird, wenn die Beschreibung zu einer Nutzeranfrage passt. Damit lassen sich konsistente Outputs (z. B. Statusberichte, Pressemitteilungen, LV-Strukturen) und Standards (Tonalität, Markenhandbuch, Briefkopf) ohne zusätzliche Klicks an jeden Chat anhängen [1].

## Aufbau einer SKILL.md

Eine SKILL.md ist eine Markdown-Datei mit YAML-Frontmatter am Anfang. Pflicht ist `name` und der Anweisungsblock unterhalb des Frontmatters, empfohlen sind `slug` und eine sehr klare `description`, weil die KI letztere zur Auswahl des Skills nutzt [2]:

```
---
name: <Anzeigename, ≤ 64 Zeichen>
slug: <kleinbuchstaben-und-bindestriche>
description: <Triggerbeschreibung mit konkreten Auslöse-Phrasen, ≤ 1024 Zeichen>
---

<Anweisungsblock, ≤ 50.000 Zeichen, reiner Text oder Markdown>
```

Die `description` ist der wichtigste Hebel für eine korrekte automatische Aktivierung. Statt vager Bezeichnungen („Statusberichte“) sollten konkrete Trigger formuliert werden („Verwenden, wenn nach einem Statusupdate, einer Fortschrittszusammenfassung oder einem Wochenbericht gefragt wird.“) [2].

## Drei Wege, einen Skill in Langdock anzulegen

In der Langdock-Doku werden drei Wege beschrieben [2]: (1) Anweisungen manuell schreiben, (2) mit dem Chat generieren lassen, (3) eine SKILL.md oder ein ZIP-Bundle hochladen. Für die IGNW empfehle ich Variante 3 mit den Mustern aus dieser Bibliothek: Datei herunterladen, an die eigenen Realitäten anpassen, hochladen.

| Methode | Wann sinnvoll | Hinweis |
| --- | --- | --- |
| Manuell schreiben | Kleinere, einfache Skills | Beschreibung sehr präzise formulieren |
| Mit Chat generieren | Schneller Erst-Entwurf | Vor dem Speichern unbedingt prüfen |
| SKILL.md oder ZIP-Bundle hochladen | Komplexere Skills mit Wissensquellen, Versionierung im Repository | Empfohlen für IGNW-Standards |

## Limits, die Sie kennen müssen

Aus den Langdock-Vorgaben [2] gelten:

| Was | Limit |
| --- | --- |
| Aktive Skills pro Nutzer | 20 |
| Verbindlich aktivierte Skills im Workspace | 8 |
| Skill-Name | 64 Zeichen |
| Beschreibung | 1.024 Zeichen |
| Anweisungen | 50.000 Zeichen |
| ZIP-Dateigröße | 25 MB, unkomprimiert ≤ 10 MB, einzelne Datei ≤ 5 MB, max. 200 Dateien |

Erlaubte Dateitypen im ZIP-Bundle sind unter anderem `.md, .mdx, .txt, .py, .sh, .js, .ts, .json, .yaml, .yml, .toml, .csv, .xml, .xsd, .html, .css, .svg, .pdf, .docx, .xlsx, .pptx, .png, .jpg, .jpeg, .gif, .webp` [2].

## Wie passe ich die IGNW-Muster an?

Jeder Muster-Skill enthält Platzhalter wie `{{KUNDE}}`, `{{PROJEKT}}`, `{{LP}}` oder `{{DATUM}}`. Der Anpassungsweg ist immer derselbe:

1. Skill in der Bibliothek öffnen.
2. Im Editor die Platzhalter mit IGNW-spezifischen Defaults befüllen, z. B. fest hinterlegte Briefkopf-Bestandteile oder Stil-Beispiele.
3. Tonalität, verbotene Begriffe und Pflichtsätze prüfen und anhand der eigenen Markenhandbuch-Inhalte ergänzen.
4. „Sicherheits- und Eskalationsregeln“ an die internen Compliance-Vorgaben anpassen (z. B. Vier-Augen-Prinzip, Freigabe durch Projektleiter, DSGVO-Hinweise).
5. Skill als SKILL.md oder als ZIP-Bundle herunterladen.
6. In Langdock unter „Skills → Skill hinzufügen → Skill hochladen“ einspielen.

Wenn Sie die Muster im Workspace dauerhaft verankern möchten, empfehlen die Langdock-Docs, sie als Workspace-Standard zu hinterlegen und für besonders wichtige Standards verbindlich zu setzen [1].

## Worauf Sie inhaltlich achten sollten

Für die IGNW besonders wichtig sind: konsistente Anrede und Tonalität in allen Texten, klar dokumentierte Schnittstellen zu HOAI-/AHO-Leistungsbildern, korrekte Bezugnahme auf Eurocodes, DIN-Normen, DWA-Arbeitsblätter und RAS/RAA, sowie eine saubere DSGVO- und Geheimhaltungslogik. Die Muster fordern in jedem Skill aktiv die fehlenden Variablen ein, kennzeichnen Annahmen und verweisen bei sicherheitskritischen Aussagen auf qualifizierte Fachplaner.

## Was Skills nicht können

Aus der Doku [2]: Skills haben kein sitzungsübergreifendes Gedächtnis (Anweisungen werden zu Beginn jeder Unterhaltung neu geladen), greifen ohne Integration nicht auf Live-Daten zu und besitzen keinen Versionsverlauf. Für Live-Datenzugriffe muss eine Integration verknüpft werden (z. B. Outlook, SharePoint, Excel, Power Automate, eigene MCPs).

## References

[1]: https://docs.langdock.com/de/product/skills/introduction "Einführung in Skills – Langdock Docs"
[2]: https://docs.langdock.com/de/product/skills/creating-skills "Skills erstellen – Langdock Docs"