Das Prinzip

„Ein Agent ohne Skills ist wie ein Mitarbeiter ohne Zugang zu den Firmen-Tools. Skills sind die Hände deiner KI — sie bestimmen, was der Agent in deiner realen Infrastruktur tun kann."

Was ist ein Skill — und was nicht?

Ein Skill ist eine definierte Fähigkeit, die ein Agent aufrufen kann. Kein generischer Prompt, sondern eine strukturierte Schnittstelle: Input → Verarbeitung → Output. Der Agent entscheidet, wann er den Skill nutzt — du definierst, was der Skill kann.

Ein Skill ist nicht:

Die Skill-Architektur

Jeder Skill in der nAIce Engine besteht aus drei Komponenten:

# Skill: E-Mail versenden
{
  "name": "send_email",
  "description": "Sendet eine E-Mail über SMTP. Agent wählt Empfänger, Betreff und Body.",
  "input_schema": {
    "to": "string (E-Mail)",
    "subject": "string",
    "body": "string (HTML erlaubt)"
  },
  "handler": "smtp_handler",
  "permissions": ["email:send"]
}

Input Schema: Was der Agent dem Skill übergeben muss. Strukturierte Parameter, keine Freitext-Prompts.
Handler: Die tatsächliche Funktion — ein API-Call, ein Webhook, ein Datenbank-Query.
Permissions: Was der Skill im System darf. Granular und überwachbar.

Die 5 wichtigsten Skill-Typen

📧

1. Kommunikations-Skills

E-Mail senden/lesen, Slack-Nachrichten, SMS, WhatsApp Business. Dein Agent wird kommunikationsfähig.

Beispiel-Handler: SMTP/IMAP, Slack Web API, Twilio

📊

2. Daten-Skills

CRM auslesen/schreiben, Datenbank-Queries, Airtable syncen, Google Sheets aktualisieren.

Beispiel-Handler: HubSpot API, PostgreSQL, Airtable API, Google Sheets API

🔍

3. Recherche-Skills

Web-Scraping, LinkedIn-Profil abrufen, Unternehmensdaten recherchieren, News-Monitoring.

Beispiel-Handler: SerpAPI, Clearbit, PhantomJS, RSS-Feed-Parser

📅

4. Kalender & Scheduling

Termine buchen, Verfügbarkeiten prüfen, Erinnerungen setzen, Meeting-Links generieren.

Beispiel-Handler: Google Calendar API, Calendly API, Zoom API

🔗

5. Webhook & Custom-Skills

Eigene API-Endpunkte ansteuern, interne Tools triggern, benutzerdefinierte Logik ausführen.

Beispiel-Handler: HTTP POST/GET, n8n-Webhooks, Zapier-Trigger, Custom Lambda

Einen eigenen Skill bauen: Step-by-Step

Schritt 1: Das Problem definieren

Frage dich: „Was soll der Agent konkret tun können, was er jetzt nicht kann?" Nicht: „Ich will eine API anbinden." Sondern: „Der Agent soll neue Leads automatisch in unser CRM eintragen."

Schreib das in einem Satz auf. Das ist dein Skill Purpose.

Schritt 2: Input Schema festlegen

Welche Daten braucht der Agent, um den Skill auszuführen? Denk an einen neuen Mitarbeiter: Was müsstest du ihm sagen, damit er die Aufgabe erledigen kann?

# Skill: Lead in CRM eintragen
input_schema:
  name: string (Vollständiger Name)
  company: string (Firmenname)
  email: string (E-Mail-Adresse)
  source: enum ["website", "linkedin", "referral", "event"]
  notes: string (optional — Qualifikationsnotizen)
Halte Input-Schemas so flach wie möglich. Keine verschachtelten JSON-Objekte, wenn es nicht sein muss. Je simpler das Schema, desto zuverlässiger füllt der Agent es aus.

Schritt 3: Handler implementieren

Der Handler ist der Code, der tatsächlich ausgeführt wird. In der einfachsten Form ein HTTP-Request:

# Minimaler Handler: HubSpot-Integration
POST https://api.hubapi.com/crm/v3/objects/contacts
Headers: Authorization: Bearer YOUR_TOKEN
Body: {
  "properties": {
    "firstname": "{{input.name}}",
    "company": "{{input.company}}",
    "email": "{{input.email}}"
  }
}

Komplexere Handler können mehrere API-Calls chainen, Daten transformieren oder Fallback-Logik enthalten. Aber starte simpel.

Schritt 4: Error Handling & Retries

Skills scheitern. Immer. Die API ist down. Der Token ist abgelaufen. Die E-Mail-Adresse ist ungültig. Ein guter Skill braucht:

„Ist doch nur ein API-Call, was soll schon schiefgehen?" — Ohne Error-Handling bleibt der Agent bei jedem Netzwerk-Flackern stecken und macht gar nichts mehr. Ein Agent ohne Error-Handling ist wie ein Mitarbeiter, der beim ersten Problem aufgibt und den Rest des Tages Kaffee trinkt.

Schritt 5: Testen — mit echten Daten

Teste deinen Skill nicht mit Dummy-Daten. Gib deinem Agenten 10 echte Testfälle und lass ihn den Skill aufrufen:

  1. 5 Happy Cases: Normale Leads, klare Daten
  2. 3 Edge Cases: Fehlende Felder, Sonderzeichen im Namen, lange Notizen
  3. 2 Error Cases: Ungültige E-Mail, API absichtlich deaktiviert

Erst wenn alle 10 Fälle korrekt behandelt werden (korrekte Ausführung ODER sauberer Fehler), ist der Skill bereit.

Skill Registry: Wiederverwendbarkeit und Versionierung

In der nAIce Console werden Skills in einer Skill Registry verwaltet. Jeder Skill hat:

Skills sind team-weit teilbar. Der Marketing-Team-Skill „Social Media Posten" kann vom Sales-Agenten genutzt werden, wenn du es freigibst. So wächst deine Skill-Library organisch mit deinem KI-Team.

Performance & Sicherheit

Rate Limiting

Ein autonomer Agent, der feuert 500 API-Calls in 2 Minuten ab. Das passiert. Definiere Limits:

Secrets-Management

API-Keys, SMTP-Passwörter, OAuth-Tokens — niemals im Skill-Code ablegen. Die nAIce Engine speichert Secrets verschlüsselt in einem Vault. Der Skill referenziert sie nur per ID:

# So NICHT:
"api_key": "sk-abc123geheim"

# So richtig:
"api_key_ref": "vault://hubspot/prod"

Die Skill-Entwicklungs-Checkliste

  1. Purpose definiert? Ein Satz, was der Skill tut.
  2. Input Schema klar? Flache Struktur, maximal 8 Parameter.
  3. Handler funktioniert? Mit 10 echten Testfällen geprüft.
  4. Error Handling drin? Timeout, Retries, klare Fehlermeldungen.
  5. Rate Limits gesetzt? Vor ungewollten API-Stürmen geschützt.
  6. Secrets im Vault? Kein Key im Code.
  7. Logging aktiv? Jeder Skill-Call wird geloggt — für Debugging und Audit.
Die goldene Regel

„Ein Skill sollte genau eine Sache tun — und die richtig. Lieber fünf kleine, zuverlässige Skills als einen Mega-Skill, der bei jedem zweiten Aufruf crasht."

Bereit für dein KI-Team?

Skills, Agenten, Orchestrierung — alles in der nAIce Console. Kein Setup. Direkt loslegen.

nAIce App starten →