Zum Inhalt springen
Docs/Integrationen/Agent Skills

Agent Skills

Verfügbar

Drei Skills, mit denen dein KI-Agent E-Rechnungen schreibt, prüft und dein bestehendes Rechnungslayout nachbaut – ZUGFeRD und XRechnung über invoice-api.xhub. Geschrieben für Claude, installierbar auch in Cursor, Codex, Gemini CLI, GitHub Copilot und weiteren Agenten. Du beschreibst die Rechnung im Chat, der Skill rechnet, ruft die API auf und legt die Datei ab.

Installierbar in

Installation mit einem Befehl

bash
1npx skills add xhubio/invoice-api.xhub-skills
Auf GitHub ansehenAuf skills.sh

Drei Skills, drei Aufgaben

Jeder Skill bringt seine eigenen Skripte mit. Claude wählt anhand deiner Anfrage den passenden aus; du kannst einen Skill aber auch beim Namen nennen.

invoice-create

Rechnung erstellen

Sammelt die Rechnungsdaten aus dem Gespräch, rechnet Positionen, Umsatzsteuer und Summen, erzeugt ZUGFeRD oder XRechnung mit Prüfung, liest das Ergebnis zurück und speichert Datei, JSON und Prüfbericht.

Beispiel-Prompt

„Erstelle eine Rechnung an die Beispiel Handel GmbH über 12 Stunden Entwicklung zu 95 € netto, Leistungszeitraum Oktober.“
invoice-read

Rechnung prüfen und auslesen

Liest eine E-Rechnung als PDF oder XML, zieht Nummer, Beteiligte, Positionen und Summen heraus und meldet Validierungsfehler und Warnungen.

Beispiel-Prompt

„Ist diese XRechnung gültig? Was steht drin?“
invoice-template-from-pdf

Eigenes Layout als Vorlage

Baut dein bestehendes Rechnungs-PDF als invoice-api-Vorlage nach: misst das Original aus, erzeugt die Vorlage, rendert sie über die API und vergleicht beides nebeneinander, bis es passt – auch Seitenumbrüche und fehlende optionale Felder.

Beispiel-Prompt

„Mach aus unserer aktuellen Rechnung (rechnung.pdf) eine invoice-api-Vorlage.“

Installation

skills-CLI

Installiert alle drei Skills. Den Agenten wählst du mit -a, z. B. -a cursor oder -a codex; mit --skill invoice-create installierst du nur diesen einen Skill.

bash
1npx skills add xhubio/invoice-api.xhub-skills

Claude Code (Plugin)

Über den Plugin-Marktplatz in Claude Code. Alternativ kopierst du die Ordner aus skills/ nach ~/.claude/skills/ (alle Projekte) oder .claude/skills/ (ein Projekt).

bash
1/plugin marketplace add xhubio/invoice-api.xhub-skills
2/plugin install invoice-api@xhubio

Claude Desktop / claude.ai

  1. 1Einen Skill-Ordner zippen, z. B. skills/invoice-create zu invoice-create.zip.
  2. 2Die ZIP-Datei in den Claude-Einstellungen im Bereich Skills hochladen.
  3. 3Die Code-Ausführung muss service.invoice-api.xhub.io erreichen dürfen. Ist der Netzzugriff in deiner Organisation eingeschränkt, gib diesen Host frei.

Geschrieben sind die Skills für Claude Code und Claude Desktop. In den übrigen Agenten haben wir am 24.10.2026 die Installation über die skills-CLI geprüft, die Ausführung dort noch nicht. Voraussetzung ist überall ein Agent, der Python-Skripte ausführen darf.

Einrichtung

  • API-Key von invoice-api.xhub

    Als Umgebungsvariable INVOICE_XHUB_API_KEY oder in einer .env im Arbeitsverzeichnis. Einen Key bekommst du auch im kostenlosen Free-Tarif.

  • Python 3.8 oder neuer

    invoice-create und invoice-read kommen mit der Standardbibliothek aus. invoice-template-from-pdf braucht zusätzlich pdfplumber und pillow (pip install pdfplumber pillow).

  • Jeder Aufruf zählt

    Die Skills rufen die API auf wie jede andere Anbindung, jeder Aufruf zählt gegen das Kontingent deines Tarifs. Eine Rechnung mit Prüfung zählt als mindestens zwei Einheiten. Der Layout-Nachbau rendert zum Vergleich mehrmals, und jeder Render ist ein Aufruf – mit den 20 Aufrufen des Free-Tarifs kommst du dabei nicht weit.

  • Der Key wird nie ausgegeben

    Die Skripte zeigen den Key nicht an und schreiben ihn in keine erzeugte Datei. Die .env gehört nicht ins Repository.

bash
1# .env in your working directory (do not commit)
2INVOICE_XHUB_API_KEY=sk_live_...
3 
4# optional: a saved PDF template
5INVOICE_XHUB_TEMPLATE_ID=<uuid>

Optional: Eine invoice-seller.json im Arbeitsverzeichnis mit deinen Firmendaten (Name, Adresse, USt-IdNr., Bankverbindung). Dann übernimmt invoice-create den Absender, ohne nachzufragen.

Die erste E-Rechnung aus dem Chat

Konto anlegen, API-Key in die .env, Skills installieren – danach beginnt die erste Rechnung mit einem Satz im Chat.

Auf GitHub ansehenKostenlos registrieren

Claude ist eine Marke von Anthropic, PBC; Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, Windsurf und die übrigen genannten Agenten sind Marken ihrer jeweiligen Inhaber. invoice-api.xhub ist mit keinem dieser Anbieter verbunden; die Skills sind ein eigenes Open-Source-Projekt unter MIT-Lizenz. skills.sh ist ein öffentliches Verzeichnis, der Eintrag dort ist keine Empfehlung Dritter.