Arbeiten mit KI

• Skills
• SKILL: otris File Type Basics

Skills

Was sind Skills?

Ein Skill ist ein Ordner mit Anleitungen (SKILL.md) und optionalen Referenzdateien. Die KI lädt ihn automatisch, wenn die Aufgabe passt. So arbeitet sie nach unseren Standards, ohne dass du jedes Mal alles erklären musst.

Skills im Überblick

Skill	Zweck	Version
otris-filetype-basics	Mappentypen und Felder per Skript anlegen, ändern, löschen (otrUpgrade)	1.0
weitere folgen

Verwenden

1. Skill-Seite im Kapitel öffnen und Installationsanleitung befolgen (ZIP oder manuell).
2. VS Code neu laden.
3. Im Agent-Modus ganz normal die Aufgabe stellen. Der Skill wird bei Bedarf automatisch geladen.

Wo liegen Skills?

KI-Tool	Ordner im Projekt
GitHub Copilot (VS Code)	.github/skills/<skill-name>/
Claude Code	.claude/skills/<skill-name>/

Der Ordnername muss mit dem name im Frontmatter der SKILL.md übereinstimmen.

Regeln

• Änderungen zuerst auf einem Testsystem prüfen.
• KI-Ergebnisse immer selbst prüfen, bevor sie auf Kundensystemen laufen.
• Keine Kundendaten, Zugangsdaten oder Secrets in Prompts oder Skills.
• Skills nicht lokal ändern. Verbesserungen an den Ersteller melden, damit alle profitieren.

Probleme

Problem	Lösung
Skill wird nicht genutzt	Agent-Modus aktiv? Ordnername = name im Frontmatter? Zielordner korrekt?
Skill veraltet	Version auf der Skill-Seite prüfen, neues ZIP laden

SKILL: otris File Type Basics

Wann greift der Skill?

Mappentypen (File Types) per Skript anlegen, erweitern, ändern und löschen, mit dem offiziellen otris-Modul otrUpgrade.

• Mappentyp oder Felder per Skript anlegen oder ändern
• Register, Aktionen, Rechte, Kategorien, Ordner
• "Mappen ändern" (submitFileChanges)
• otr-package Update-Skripte oder PortalScript

Kein projektspezifischer Code, nur otris-Standard.

Inhalt

Datei	Zweck
SKILL.md	Anleitung: Typings, Update-Skripte, Operationen, Spec-Keys, Stolperfallen
references/otrupgrade-api.md	Funktionsliste otrUpgrade (✅ = im Projekt geprüft, ⚪ = nur aus Typings bekannt)

Voraussetzungen

Voraussetzung	Details
VS Code Extension documentsOS	Typings installieren (Install Typings)
fileTypes.d.ts	Befehl Get File Type Typings, nach jeder Mappentyp-Änderung neu
jsconfig.json	Template der Extension (Pfade zu otrUpgrade)
KI mit Skills-Support	GitHub Copilot (Agent-Modus) oder Claude Code

Hinweise

• Änderungen immer zuerst auf einem Testsystem prüfen.
• Funktionen mit ⚪ vor dem Einsatz testen.

Installation

1. Zielordner wählen

KI-Tool	Ordner im Projekt
GitHub Copilot (VS Code)	.github/skills/otris-filetype-basics/
Claude Code	.claude/skills/otris-filetype-basics/

2. Dateien anlegen

Skill-Dateien als ZIP: otris-filetype-basics.zip

Variante A: ZIP (empfohlen)

1. ZIP otris-filetype-basics.zip von der Seite Übersicht herunterladen.
2. ZIP in den Zielordner entpacken (.github/skills/ bzw. .claude/skills/).
3. Prüfen, dass die Struktur stimmt (siehe unten).
4. VS Code neu laden (Developer: Reload Window).

Variante B: Manuell

1. Ordner otris-filetype-basics im Zielordner anlegen (Name exakt so).
2. Darin SKILL.md anlegen, Inhalt von der Seite SKILL.md kopieren.
3. Unterordner references anlegen, darin otrupgrade-api.md mit dem Inhalt der Seite Referenz.
4. VS Code neu laden (Developer: Reload Window).

Erwartete Struktur (beide Varianten)

.github/skills/            (bzw. .claude/skills/)
└── otris-filetype-basics/
    ├── SKILL.md
    └── references/
        └── otrupgrade-api.md

Achtung: Beim Entpacken darf kein doppelter Ordner entstehen (otris-filetype-basics/otris-filetype-basics/SKILL.md). SKILL.md muss direkt im Ordner otris-filetype-basics liegen.

3. Testen

Im Agent-Modus fragen: "Wie lege ich per Update-Skript ein neues Feld an einem Mappentyp an?" Die Antwort sollte attachFieldToFileType und submitFileChanges nennen.

Häufige Probleme

Problem	Lösung
Skill wird nicht gefunden	Ordnername ≠ name im Frontmatter, oder falscher Zielordner
Referenz wird nicht geladen	Datei muss in references/ liegen
Skill nicht aktiv (Copilot)	Agent-Modus verwenden, VS Code aktuell halten