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)
- ZIP otris-filetype-basics.zip von der Seite Übersicht herunterladen.
- ZIP in den Zielordner entpacken (
.github/skills/bzw..claude/skills/). - Prüfen, dass die Struktur stimmt (siehe unten).
- VS Code neu laden (Developer: Reload Window).
Variante B: Manuell
- Ordner
otris-filetype-basicsim Zielordner anlegen (Name exakt so). - Darin
SKILL.mdanlegen, Inhalt von der Seite SKILL.md kopieren. - Unterordner
referencesanlegen, darinotrupgrade-api.mdmit dem Inhalt der Seite Referenz. - VS Code neu laden (Developer: Reload Window).
Erwartete Struktur (beide Varianten)
.github/skills/ (bzw. .claude/skills/)
└── otris-filetype-basics/
├── SKILL.md
└── references/
└── otrupgrade-api.mdAchtung: 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 |