Skip to main content

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

No comments to display

Back to top