Was sind Skills und wie funktionieren sie? Softwareentwicklung mit KI

Agent Skills sind ein Werkzeug für die Arbeit mit KI-Agenten. Im Kontext dieses Artikels liegt der Fokus auf Claude Code und darauf, wie es sich mithilfe von Skills um Wissen und Arbeitsabläufe ergänzen lässt. Im Kern ist ein Skill nichts anderes als ein Ordner mit einer SKILL.md-Datei, die Anweisungen, Regeln und optionale Ressourcen enthält. Claude kann einen passenden Skill selbstständig laden, falls eine Aufgabe dazu passt, oder ein Skill wird explizit über einen Slash-Command aufgerufen. Dieser Artikel zeigt, wie Skills aufgebaut sind, wie Claude sie lädt, warum die Beschreibung in diesem Kontext einer der wichtigsten Aspekte ist, und worauf es beim Entwickeln eines Skills ankommt.

‍

Was ist ein Agent Skill?

Ein Skill ist eigentlich nur ein Ordner mit einer SKILL.md-Datei. In dieser Datei werden der Name des Skills, eine Beschreibung (Description) und eine Anweisung (Body) definiert. Wenn ein Skill aufgerufen wird (automatisch oder explizit), wird der Inhalt des Skills in den Kontext geladen und dem Agenten übermittelt. Streng genommen macht ein Skill nichts, was sich nicht auch ohne Skill erreichen ließe. Aber genau dann, wenn sich Aufgaben, Richtlinien oder Prozesse wiederholen, können Skills genutzt werden. Sie ersparen es, immer wieder alles in den Prompt zu tippen, und schützen davor, Fehler zu machen bzw. von den Vorgaben abzuweichen.

‍

Wie ist ein Skill aufgebaut?

Die Struktur eines Skills ist schlank. Wie bereits beschrieben, muss ein Skill nur aus einer SKILL.md-Datei bestehen. Optional werden weitere Verzeichnisse und Dateien hinzugefügt. Der Ordner könnte so aufgebaut sein:

‍

mein-skill/
├─ SKILL.md
│    Pflicht: Name, Description, Anleitung
├─ references/
│    Doku, wird bei Bedarf gelesen
├─ scripts/
│    ausführbarer Code
└─ assets/
     Templates, Fonts, Icons

Da ein Skill nur aus Dateien besteht, kann er Teil eines Repositories sein und innerhalb eines Teams bzw. Projekts gemeinsam genutzt werden. Grundsätzlich bieten sich zwei Möglichkeiten, Skills abzulegen. Wenn sich ein Skill auf ein Projekt bezieht, in dem Claude Code genutzt wird, wird er in .claude/skills/<name>/... abgelegt. Wenn sich ein Skill auf alle Projekte beziehen soll, aber persönlich ist, d. h. nicht Teil eines Repositories ist, kann er im Benutzerverzeichnis unter ~/.claude/skills/<name>/... abgelegt werden. Alternativ besteht die Möglichkeit, über eine Organisation in Claude allen Mitgliedern der Organisation Skills zur Verfügung zu stellen. Diese werden dann nicht lokal auf der Festplatte gespeichert, sondern sind über die Claude App verfügbar.

‍

Wie wird ein Skill geladen?

Damit viele Skills gleichzeitig existieren können, ohne den Kontext zu überladen, werden sie nicht auf einmal, sondern in drei Stufen geladen. Dieses Prinzip heißt Progressive Disclosure. Informationen aus der Skill-Definition werden erst dann sichtbar bzw. geladen, wenn sie gebraucht werden.

Stufe 1: Metadaten (immer im Kontext)

Anhand von name und description eines Skills entscheidet Claude, ob ein Skill benutzt werden soll oder nicht. Daher müssen diese Metadaten immer im Kontext enthalten sein und sollten möglichst kurz, aber trotzdem präzise sein. Alle Skills aus dem persönlichen Nutzerverzeichnis, alle Skills aus dem aktuellen Verzeichnis (mit Unterordnern) und alle Skills aus der Organisation werden hier mit ihren Metadaten geladen.

Stufe 2: SKILL.md-Body (bei Trigger)

Erst wenn ein Skill triggert, wird die eigentliche Anleitung im Body der SKILL.md geladen. Der Body sollte auch nicht unendlich lang und ausführlich sein. Es sollte eine klare Anweisung für den Agenten sein, die bei Bedarf auf weitere Ressourcen verweist.

Stufe 3: Ressourcen (bei Bedarf)

Die Inhalte aus references/, scripts/ und assets/ werden nur dann geladen, wenn im Body der SKILL.md explizit auf sie verwiesen wird und der Agent beim Ausführen des Skills erkennt, dass diese Ressourcen benötigt werden.

Insgesamt lässt sich eine klare Arbeitsteilung festhalten: Name und Description eines Skills tragen die Trigger-Logik, der Body trägt das Wissen und die Handlungsanweisung, und die Ressourcen enthalten optionale Detail-Informationen.

‍

SKILL.md im Detail

Eine SKILL.md besteht aus zwei Teilen: einem YAML-Frontmatter am Anfang und einem eigentlichen Body in Markdown-Format. Zum Beispiel:

‍

---
name: mein-skill
description: Meine Beschreibung für den Skill. Hier entscheidet Claude, ob ein Skill 		automatisch getriggert werden soll, oder nicht. 
---

Ab hier folgt der Body in Markdown. Dies kann freier Text sein 

# Überschrift 

## Unterüberschrift 

    Oder es wird Markdown für bessere Strukturierung genutzt 

    KI-Agenten/-Modelle sind sehr gut darin Markdown zu verstehen 

Für weitere Details siehe references/details.md

Kein Feld eines Skills ist so entscheidend wie die description. Sie bestimmt, ob Claude den Skill überhaupt in Betracht zieht. Der Unterschied zwischen einer vagen und einer konkreten, präzisen description ist der Unterschied zwischen einem Skill, der nie greift, und einem, der zuverlässig triggert.

‍

Eine Definition, zwei Anwendungsfälle

Es gibt zwei Wege, einen Skill zu nutzen. Skills können automatisch von Claude genutzt werden. Name und Description des Skills sowie der Kontext der Anforderung entscheiden darüber, ob Claude einen Skill lädt. In diesem Fall handelt es sich um Konventionen. Sie gelten, ohne dass jemand daran denken muss, und sollen zuverlässig angewandt werden.

Alternativ lässt sich ein Skill explizit über einen Slash-Command aufrufen. Zum Beispiel, indem man im Chat „/mein-skill" schreibt. Optional gibt man zusätzliche Informationen mit: „/mein-skill Hier stehen zusätzliche Informationen, die für die Aufgabe relevant sind". Wenn man einen neuen Skill entwickelt, möchte man ihn zu Testzwecken häufiger explizit aufrufen. Ansonsten werden Skills dann explizit aufgerufen, wenn es sich nicht um Konventionen, sondern um Prozesse oder Workflows handelt, z. B. ein spezieller Review-Prozess oder ein spezieller Vorgang zum Implementieren neuer Features (Diskussion -> Planung -> Implementation).

‍

Fazit: Skills als iteratives Werkzeug in der Praxis

Ein guter Skill fällt nicht vom Himmel und auch nicht aus dem Git-Repository einer fremden Person. Skills entstehen über einen Zeitraum hinweg, iterativ, in Kombination mit den individuellen Prozessen eines Teams. Sie helfen dabei, wiederkehrendes Wissen und Abläufe in eine Form zu gießen. Der Einstieg, um mit Skills zu arbeiten, ist sehr niedrigschwellig: Ein funktionierender Skill lässt sich innerhalb einer Minute erstellen. Die Herausforderung liegt nicht in der Technik selbst, sondern im Inhalt.

Dabei sollte nicht vergessen werden, dass KI und ihre Nutzung in der Softwareentwicklung immer noch in den Kinderschuhen stecken. Bewährte Prozesse aus der Vergangenheit sollten nicht über Bord geworfen werden, nur weil ein Skill dabei helfen kann. Es handelt sich um eine Zeit des Experimentierens und Ausprobierens, in der der Blick für den konkreten Nutzen nicht verloren gehen sollte.

Es empfiehlt sich, Agent Skills auszuprobieren, eigene Skills zu entwickeln und Teil derjenigen zu sein, die aus Erfahrung heraus neue Erkenntnisse zu Claude Code generieren. Gleichzeitig sollte der Blick auf jahrzehntelange Erfahrung nicht verloren gehen.