Skill vs. Skript: Universelle Werkzeuge für AI-Agenten

In der letzten Lektion hast du ein Skript erstellt, das „Hello World" in deinen Kanal postet. Es funktioniert. Aber es hat ein Problem: Es ist ein Einweg-Skript. Es tut genau eine Sache, auf genau eine Art, für genau einen Anwendungsfall.

Was passiert, wenn du den Kanal wechselst? Neues Skript. Anderen Text posten? Skript anpassen. Bild hinzufügen? Skript umschreiben.

Es gibt einen besseren Weg: Skills.

Was ist ein Skill?

Ein Skill ist eine strukturierte Anleitung, die ein AI-Agent ausführen kann. Im Gegensatz zu einem Skript beschreibt ein Skill nicht den Code, sondern die Aufgabe.

Die Kochbuch-Metapher

Stell dir ein Kochbuch vor:

Ein Skript ist wie ein exaktes Rezept für eine bestimmte Küche mit bestimmten Geräten:

„Nimm die 24cm Tefal-Pfanne aus dem dritten Schrank links. Stelle sie auf die hintere rechte Herdplatte. Drehe den Knopf auf Stufe 7..."

Wechselst du die Küche, ist das Rezept nutzlos.

Ein Skill ist wie ein universelles Rezept:

„Erhitze eine Pfanne auf mittlere Hitze. Gib Öl hinein. Wenn das Öl schimmert, brate das Fleisch von jeder Seite 3 Minuten."

Dieses Rezept funktioniert in jeder Küche, mit jeder Pfanne, auf jedem Herd. Weil es die Aufgabe beschreibt, nicht die Implementierung.

Genau so funktionieren Skills für AI-Agenten.

Warum Skills statt Skripte?

Problem 1: Skripte sind fragil

Ein Skript ist an seine Umgebung gebunden:

• Bestimmte Node.js-Version
• Bestimmte Paket-Versionen
• Bestimmte Dateistruktur
• Bestimmtes Betriebssystem

Ändert sich etwas davon, bricht das Skript. Du musst es reparieren oder neu schreiben.

Ein Skill ist umgebungsunabhängig. Der AI-Agent liest den Skill und passt die Implementierung an die aktuelle Umgebung an. Node.js installiert? Er nutzt Node.js. Nur Python da? Er nutzt Python. Andere Paketversionen? Er passt den Code an.

Problem 2: Skripte sind nicht wiederverwendbar

Dein bot.js sendet „Hello World" an @ai_news_daily. Wenn du:

• Einen anderen Kanal nutzen willst → Code ändern
• Einen anderen Text senden willst → Code ändern
• Ein Bild hinzufügen willst → Code umschreiben
• Einen anderen Bot nutzen willst → Code umschreiben

Ein Skill definiert die Aufgabe abstrakt: „Sende einen Post an einen Telegram-Kanal." Die Details (welcher Kanal, welcher Text, welches Format) sind Parameter.

Problem 3: Skripte brauchen Wartung

Libraries werden aktualisiert. APIs ändern sich. Betriebssysteme bekommen Updates. Dein Skript von heute funktioniert vielleicht in 6 Monaten nicht mehr.

Ein Skill braucht keine Wartung, weil er keinen Code enthält. Der AI-Agent generiert den Code jedes Mal neu — basierend auf der aktuellen Umgebung, den aktuellen Libraries, den aktuellen Best Practices.

Problem 4: Skripte sind nicht übertragbar

Du wechselst von Claude zu ChatGPT. Oder von Cursor zu Windsurf. Dein Skript funktioniert vielleicht noch (wenn die Runtime gleich ist), aber der neue Agent versteht den Kontext nicht.

Ein Skill ist ein Dokument in natürlicher Sprache. Jeder Agent kann ihn lesen und verstehen. Du kannst denselben Skill mit Claude, ChatGPT, Gemini oder jedem anderen Agenten verwenden.

Die Skill-Struktur

Ein guter Skill hat folgende Bestandteile:

# Skill-Name

## Beschreibung
Was dieser Skill tut, in 1-2 Sätzen.

## Voraussetzungen
Was vorhanden sein muss, bevor der Skill ausgeführt wird.

## Parameter
Welche Informationen der Skill benötigt (Input).

## Schritte
Die Schritte, die der Agent ausführen soll.

## Erwartetes Ergebnis
Was am Ende herauskommen soll (Output).

## Fehlerbehandlung
Was bei typischen Fehlern zu tun ist.

Dein erster Skill: Auto-Posting

Lass uns das „Hello World"-Skript in einen Skill umwandeln.

Der Skill

# Telegram Auto-Post

## Beschreibung
Sendet einen formatierten Post in einen Telegram-Kanal.

## Voraussetzungen
- Telegram Bot-Token in .env als TELEGRAM_BOT_TOKEN
- Telegram Kanal-Handle oder ID in .env als TELEGRAM_CHANNEL_HANDLE
- Bot muss Admin im Kanal sein mit Posting-Rechten

## Parameter
- **text** (erforderlich): Der Text des Posts
- **format** (optional): "plain", "markdown" oder "html" — Standard: "markdown"
- **image** (optional): URL oder Dateipfad eines Bildes

## Schritte
1. Lese Bot-Token und Kanal-Handle aus der .env-Datei
2. Wenn ein Bild angegeben ist:
   a. Sende das Bild mit dem Text als Bildunterschrift
3. Wenn kein Bild angegeben ist:
   a. Sende den Text als Nachricht
4. Verwende das angegebene Format für die Textformatierung
5. Logge das Ergebnis (Erfolg oder Fehler)

## Erwartetes Ergebnis
- Der Post erscheint im Telegram-Kanal
- Die Konsole zeigt eine Erfolgsmeldung mit Message-ID

## Fehlerbehandlung
- Bei 401: Token ist ungültig → Token in .env prüfen
- Bei 403: Bot hat keine Rechte → Admin-Status im Kanal prüfen
- Bei 400: Kanal nicht gefunden → Handle/ID prüfen
- Bei Netzwerkfehler: Internetverbindung prüfen, nach 5 Sekunden erneut versuchen

Wie du den Skill benutzt

Statt dem Agenten zu sagen „schreibe ein Skript, das ...", sagst du:

„Führe den Telegram Auto-Post Skill aus. Text: ‚Hallo Welt! Erster automatischer Post.' Format: Markdown."

Der Agent liest den Skill, versteht die Aufgabe und implementiert sie — in der Sprache und mit den Tools, die in deiner Umgebung verfügbar sind.

Der Unterschied in der Praxis

Mit Skript:

Du: "Führe bot.js aus"
Agent: *führt node bot.js aus*
Fehler: "Cannot find module 'node-telegram-bot-api'"
Du: "Installiere die Abhängigkeiten"
Agent: *npm install*
Du: "Jetzt führe es aus"
Agent: *führt aus*
Fehler: "node-telegram-bot-api is deprecated, use grammy"
Du: "Dann benutze grammy"
Agent: *schreibt das Skript um*
...

Mit Skill:

Du: "Führe den Telegram Auto-Post Skill aus. Text: 'Hallo Welt!'"
Agent: *liest Skill, erkennt Umgebung, wählt aktuelle Library,
       schreibt Code, installiert Pakete, führt aus*
Ergebnis: "Post erfolgreich gesendet. Message-ID: 42"

Ein Schritt statt fünf. Der Agent trifft die technischen Entscheidungen selbst, basierend auf der Skill-Beschreibung.

Lokale vs. Globale Skills

Skills können an zwei Orten gespeichert werden:

Lokale Skills (Projekt-spezifisch)

Gespeichert im Projektordner, z.B. unter .claude/skills/ oder .cursor/skills/:

dein-projekt/
├── .claude/
│   └── skills/
│       ├── telegram-auto-post.md
│       ├── content-generierung.md
│       └── bild-erstellung.md
├── .env
└── ...

Lokale Skills gelten nur für dieses Projekt. Sie kennen den Kontext: welche .env-Variablen existieren, welche Dateistruktur vorhanden ist, welche Konventionen gelten.

Globale Skills (überall verfügbar)

Gespeichert an einem zentralen Ort, z.B. ~/.claude/skills/:

~/.claude/
└── skills/
    ├── telegram-auto-post.md
    ├── github-commit.md
    └── web-recherche.md

Globale Skills sind in jedem Projekt verfügbar. Sie sind allgemeiner formuliert und nicht an ein bestimmtes Projekt gebunden.

Wann welcher Typ?

Skill-Typ	Verwende wenn...	Beispiel
Lokal	Der Skill projektspezifisch ist	„Poste in MEINEN Kanal @ai_news_daily"
Global	Der Skill überall nützlich ist	„Poste in EINEN Telegram-Kanal"

Faustregel: Starte lokal. Wenn du merkst, dass du denselben Skill in mehreren Projekten brauchst, mache ihn global.

Einen Skill schreiben lassen

Du musst Skills nicht selbst schreiben. Sag deinem Agenten:

„Erstelle einen Skill für Telegram-Auto-Posting. Der Skill soll als Markdown-Datei unter .claude/skills/telegram-auto-post.md gespeichert werden. Er soll beschreiben, wie ein formatierter Post mit optionalem Bild in einen Telegram-Kanal gesendet wird."

Der Agent schreibt den Skill für dich. Du prüfst ihn und passt ihn bei Bedarf an.

Skills kombinieren

Die wahre Macht von Skills zeigt sich, wenn du sie kombinierst:

1. Skill: "Web-Recherche" → Sammelt aktuelle AI-News
2. Skill: "Content-Generierung" → Schreibt einen Post basierend auf den News
3. Skill: "Telegram Auto-Post" → Veröffentlicht den Post im Kanal

Du sagst dem Agenten:

„Recherchiere die Top-3-AI-News von heute, schreibe einen 200-Wort-Post darüber und poste ihn in meinen Telegram-Kanal."

Der Agent führt alle drei Skills nacheinander aus. Automatisch. Ohne dass du jeden Schritt einzeln anweisen musst.

Das ist die Content-Fabrik aus Lektion 2 in Aktion.

Skills und MCP

Für fortgeschrittene Nutzer: Skills können mit dem Model Context Protocol (MCP) kombiniert werden. MCP ist ein Standard, der es AI-Agenten ermöglicht, mit externen Tools zu kommunizieren. Statt den Code jedes Mal neu zu generieren, kann ein MCP-Server den Skill als permanentes Tool bereitstellen.

Das ist aber ein Thema für später. Für jetzt: Skills als Markdown-Dateien reichen völlig aus.

Übung

Erstelle deinen ersten Skill:

1. Öffne deinen AI-Agent
2. Sage: „Erstelle einen Skill namens ‚Telegram Auto-Post' als Markdown-Datei. Der Skill soll beschreiben, wie ein Post mit optionalem Bild und Markdown-Formatierung in einen Telegram-Kanal gesendet wird. Speichere ihn unter .claude/skills/telegram-auto-post.md"
3. Prüfe das Ergebnis
4. Teste den Skill: „Führe den Telegram Auto-Post Skill aus. Text: ‚Erster Skill-basierter Post!'"

Wenn der Post im Kanal erscheint, hast du dein erstes wiederverwendbares Werkzeug gebaut.

Zusammenfassung

• Skripte sind fragil, einmalig und wartungsintensiv
• Skills sind universell, wiederverwendbar und wartungsfrei
• Ein Skill beschreibt die Aufgabe, nicht den Code
• Skills funktionieren mit jedem AI-Agent
• Starte mit lokalen Skills und mache sie global, wenn nötig
• Kombinierte Skills = automatisierte Pipelines
• Du musst Skills nicht selbst schreiben — lass den Agenten das tun

Skills sind das Fundament jeder Vibe-Coding-Automatisierung. Lerne sie zu nutzen und du wirst nie wieder Einweg-Skripte schreiben.

Weiter geht's: In den nächsten Lektionen baust du weitere Skills und kombinierst sie zu einer vollständigen Content-Pipeline. Besuche auch unsere Skills-Sammlung und Tools-Übersicht für Inspiration.