Kanonische HTML-Seite
Der menschlich lesbare Inhalt ist die Referenz für Suchmaschinen, Screenreader und interne Reviews.
Developer Hub
HTML-first, API-ready, offen integrierbar.
Der Developer Hub zeigt, welche Datenfelder, Metadaten und Schnittstellen für OSC-kompatible Implementierungen zählen.
Integrationspfad
Von lesbarer Skill-Seite zu stabiler Schnittstelle.
OSC-Implementierungen sollen zuerst im Web verständlich sein und danach verlässlich in APIs, Exporte und Partnerprozesse fließen.
Strukturierte Kernfelder
Identifier, Bezeichnung, Beschreibung, Version und Quelle bleiben über Ausgabeformate hinweg identisch.
Exportprofile
JSON und CSV geben Produktteams reproduzierbare Daten für Import, Matching und Qualitätssicherung.
Review und Versionierung
Änderungen werden nachvollziehbar freigegeben, damit Integrationen planbar aktualisiert werden können.
Prinzipien
Robust, lesbar, integrierbar.
Inhalte bleiben ohne Spezial-Client verständlich. Maschinen erhalten dieselben Kerninformationen über dokumentierte Attribute und strukturierte Daten.
Semantisches HTML
Kerninformationen bleiben ohne Spezial-Client lesbar, indexierbar und barrierearm.
Progressive Interaktion
Filter und Vorschauen beschleunigen Nutzung, ersetzen aber keine Inhalte.
Stabile Verträge
Identifier, Versionen und Fehlerantworten sind explizit dokumentiert.
Metadaten
Pflichtfelder für Skill-Seiten.
Die Liste beschreibt den geplanten OSC-Arbeitsstand und ist bis zur Veröffentlichung bewusst als Referenzmuster formuliert.
- stabiler Skill-Identifier
- bevorzugte deutsche Bezeichnung
- kurze, fachlich prüfbare Beschreibung
- Herausgeber, Version und Aktualisierungsdatum
- Lizenz- und Nutzungsangaben
- verwandte Skills und Cluster
Exporte und API
Beispiel-Endpunkte für den vorgesehenen Integrationspfad.
Die Beispiele markieren die erwartete Richtung für lesbare Kataloge, maschinenlesbare Exporte und prüfbare Evidenzprozesse.
GET /osc/skills/
GET /osc/skills/export.json
GET /osc/api/v1/skills/?language=de
GET /osc/api/v1/skills/{skill_id}/
POST /osc/api/v1/evidence/verify/Antwortverhalten
HTML-Seiten liefern kanonische Inhalte. JSON- und CSV-Exporte enthalten dieselben Kernfelder mit maschinenlesbaren Identifiern, Versionen und Quellen.