# 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

<table border="1" id="bkmrk-datei-zweck-skill.md"><thead><tr><th>Datei</th><th>Zweck</th></tr></thead><tbody><tr><td>`SKILL.md`</td><td>Anleitung: Typings, Update-Skripte, Operationen, Spec-Keys, Stolperfallen</td></tr><tr><td>`references/otrupgrade-api.md`</td><td>Funktionsliste otrUpgrade (✅ = im Projekt geprüft, ⚪ = nur aus Typings bekannt)</td></tr></tbody></table>

### Voraussetzungen

<table border="1" id="bkmrk-voraussetzung-detail"><thead><tr><th>Voraussetzung</th><th>Details</th></tr></thead><tbody><tr><td>VS Code Extension **documentsOS**</td><td>Typings installieren (*Install Typings*)</td></tr><tr><td>`fileTypes.d.ts`</td><td>Befehl *Get File Type Typings*, nach jeder Mappentyp-Änderung neu</td></tr><tr><td>`jsconfig.json`</td><td>Template der Extension (Pfade zu otrUpgrade)</td></tr><tr><td>KI mit Skills-Support</td><td>GitHub Copilot (Agent-Modus) oder Claude Code</td></tr></tbody></table>

### Hinweise

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

### Installation

#### 1. Zielordner wählen

<table border="1" id="bkmrk-ki-tool-ordner-im-pr"><thead><tr><th>KI-Tool</th><th>Ordner im Projekt</th></tr></thead><tbody><tr><td>GitHub Copilot (VS Code)</td><td>`.github/skills/otris-filetype-basics/`</td></tr><tr><td>Claude Code</td><td>`.claude/skills/otris-filetype-basics/`</td></tr></tbody></table>

#### 2. Dateien anlegen

Skill-Dateien als ZIP: [otris-filetype-basics.zip](https://docs.squeeze.one/attachments/2)

##### 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

<table border="1" id="bkmrk-problem-l%C3%B6sung-skill"><thead><tr><th>Problem</th><th>Lösung</th></tr></thead><tbody><tr><td>Skill wird nicht gefunden</td><td>Ordnername ≠ `name` im Frontmatter, oder falscher Zielordner</td></tr><tr><td>Referenz wird nicht geladen</td><td>Datei muss in `references/` liegen</td></tr><tr><td>Skill nicht aktiv (Copilot)</td><td>Agent-Modus verwenden, VS Code aktuell halten</td></tr></tbody></table>