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/basics.zip ├──von SKILL.mdder └──Seite references/Übersicht └──herunterladen.
    2. 
otrupgrade-api.md
  2. 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
    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
    Back to top