Anatomie eines Skills

Woraus ein installierbarer Skill besteht – Pflichtbestandteil und optionale Zusatzdateien

mein-skill/ (als Ordner oder gepackt als .skill-Datei)

SKILL.md Pflicht

YAML-Frontmatter

name und description – bestimmen, ob und wann der Skill überhaupt vorgeschlagen wird. Nur diese ~100 Wörter sind immer im Kontext.

Markdown-Anleitung

Der eigentliche Ablauf: Schritte, Regeln, Beispiele. Wird geladen, sobald der Skill ausgelöst wird – idealerweise unter 500 Zeilen.

Gebündelte Ressourcen Optional

scripts/

Ausführbarer Code für feste, sich wiederholende Aufgaben – läuft ohne dass der Inhalt selbst gelesen werden muss.

convert.pybuild.js

references/

Nachschlage-Dokumente, die erst bei Bedarf nachgeladen werden – für Details, die nicht ständig im Kontext stehen müssen.

schemas.mdapi.md

assets/

Dateien, die direkt ins Ergebnis einfließen: Vorlagen, Schriften, Icons, Beispielbilder.

template.docxfonts/

Progressive Disclosure

Drei Ladestufen – nur so viel Kontext wie gerade nötig

Metadaten

Name + Beschreibung sind immer geladen, damit das KI-System überhaupt weiß, dass es den Skill gibt und wofür er da ist.

~100 Wörter · immer im Kontext

→

SKILL.md-Inhalt

Die vollständige Anleitung wird geladen, sobald der Skill tatsächlich ausgelöst wird.

idealerweise < 500 Zeilen

→

Ressourcen

Scripts, Referenzen und Assets werden erst bei konkretem Bedarf nachgeladen bzw. ausgeführt.

unbegrenzt · nach Bedarf

ℹ︎

Einzige Pflichtdatei ist SKILL.md – ein Skill kann also auch nur aus dieser einen Datei bestehen. Zum Installieren wird der Ordner als .skill-Datei (ZIP-Archiv) gepackt oder als einzelne SKILL.md geteilt. Das SKILL.md-Format ist seit Ende 2025 ein offener Standard (agentskills.io) und wird u. a. von Claude, ChatGPT/Codex, Cursor und weiteren KI-Tools gelesen – wie genau die Installation bestätigt wird, hängt vom jeweiligen Tool ab.