openapi/openapi-skills

Agent-Skills zur Nutzung und Integration der Dienste des Openapi-API-Marktplatzes – dem größten zertifizierten API-Marktplatz Europas.

npx skills add openapi/openapi-skills

Repository-Struktur

Ordner	Zweck
knowledge/	Kuratierte Wissensbasis: Firmenprofil, Dienstekatalog, Plattformleitfaden (Authentifizierung, Abrechnung, Sandbox), FAQ, Referenzen, dienstspezifische Endpunktdokumentation und bereitgestellte OpenAPI-Spezifikationen
skills/	Die Agent-Skills, ein Ordner pro Domäne, jeder mit einer SKILL.md

Trennung von Wissen und Skills

Die beiden Ordner haben streng getrennte Rollen:

• knowledge/ ist Baumaterial zur Erstellungszeit. Es ist die Masse kuratierter Informationen, die verwendet wird, um die Skills zu erstellen und abzugleichen (und sie zu aktualisieren, wenn sich Openapi ändert). Es wird von den Betreuern dieses Repos konsultiert, nicht von Agenten, die einen Skill ausführen.
• skills/ sind eigenständige Liefergegenstände. Jede SKILL.md wird aus dem Wissen befüllt, verlinkt aber nie darauf: Ein Agent muss einen Skill nutzen können, ohne dass der Ordner knowledge/ dieses Repos verfügbar ist.
• Externe Referenzen sind in Skills erlaubt, werden aber nie durch knowledge/ geleitet. Skills verweisen direkt auf offizielle Quellen – z. B. die kanonischen Spezifikationen unter https://console.openapi.com/oas/en/<service>.openapi.json, das Dokumentationsportal, die Statusseite – nicht auf lokale Kopien davon.

Wartungsablauf: Aktualisieren Sie zuerst knowledge/ aus den offiziellen Quellen, propagieren Sie dann die relevanten Inhalte in die betroffenen SKILL.md-Dateien.

Skills

Skill	Abdeckung
openapi-auth	OAuth v2-Token-Lebenszyklus, Scopes, Wallet, Nutzungsstatistiken (von allen anderen benötigt)
openapi-company	Firmendaten: Italien, EU, weltweit
openapi-documents	Amtliche Dokumente: Visure Camerali, Bilanzberichte, DURC, Proteste (DocuEngine, Visure Camerali, Visengine)
openapi-risk	Bonitätsbewertungen, CRIF-Berichte, KYC, negative Ereignisse
openapi-trust	Validierung von E-Mails, Telefonen, IPs, URLs, PEC, Steuernummern, Kennzeichen
openapi-geo	Geokodierung, Postleitzahlen, italienisches Kataster, Immobilienbewertungen
openapi-messaging	SMS v2, PEC, Massen-REM, Briefpost über Poste Italiane
openapi-esignature	eIDAS-E-Signaturen und qualifizierte Zeitstempel
openapi-invoicing	Elektronische Rechnungsstellung (Invoice, SDI) und Rechnungszahlungen
openapi-automotive	Fahrzeugdaten anhand des Kennzeichens
openapi-utilities	Wechselkurse, HTML-zu-PDF, .it-Domains, verwaltetes RAG

Anmeldedaten

Skills erwarten OPENAPI_EMAIL und OPENAPI_API_KEY (Kontoanmeldedaten für oauth.openapi.com) und/oder ein fertiges OPENAPI_TOKEN-Bearer-Token in der Umgebung. Siehe knowledge/platform-guide.md.

Mitwirken

Beiträge sind immer willkommen! Ob Sie Fehler melden, neue Funktionen vorschlagen, die Dokumentation verbessern oder Code beitragen möchten – Ihre Hilfe wird geschätzt.

Autoren

• Francesco Bianco (@francescobianco)
• Openapi Team (@openapi-it)

Partner

Lernen Sie unsere Partner kennen, die Openapi nutzen oder zu diesem Projekt beitragen:

• Blank
• Credit Safe
• Deliveroo
• Gruppo MOL
• Jakala
• Octotelematics
• OTOQI
• PWC
• QOMODO S.R.L.
• SOUNDREEF S.P.A.

Unsere Verpflichtungen

Wir glauben an Open Source und handeln entsprechend. Wir sind Silver Members der Linux Foundation geworden, weil wir das Ökosystem, auf das wir täglich aufbauen, formal unterstützen möchten. Offene Standards, offene Zusammenarbeit und offene Governance sind Teil unserer Arbeitsweise und unserer Denkweise über Software.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Die MIT-Lizenz ist eine freizügige Open-Source-Lizenz, die es Ihnen erlaubt, die Software frei zu nutzen, zu kopieren, zu modifizieren, zusammenzuführen, zu veröffentlichen, zu verteilen, zu unterlizenzieren und/oder zu verkaufen, vorausgesetzt, dass der ursprüngliche Urheberrechtshinweis und dieser Genehmigungshinweis in allen Kopien oder wesentlichen Teilen der Software enthalten sind.

Weitere Details finden Sie im vollständigen Lizenztext auf der MIT-Lizenzseite.