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

otris-filetype-basics/
├── SKILL.md
└── references/
    └── otrupgrade-api.md

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

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