add-provider-package
von verceladd-provider-package ist ein fokussierter Leitfaden zum Erstellen eines neuen @ai-sdk/<provider>-Pakets in vercel/ai. Er unterstützt Mitwirkende und API-Teams dabei, die Provider-Architektur, Paketstruktur und den Implementierungsablauf des AI SDK einzuhalten, wenn ein neuer Provider hinzugefügt wird.
Diese Skill-Bewertung liegt bei 68/100. Damit ist sie für Verzeichnisnutzer grundsätzlich auffindbar, sollte aber eher als implementierungsorientierter Leitfaden für Mitwirkende verstanden werden als als sofort nutzbare Install-and-run-Skill. Die Repository-Hinweise belegen einen substanziellen Workflow zum Hinzufügen eines neuen `@ai-sdk/<provider>`-Pakets, die praktische Nutzung erfordert jedoch die Lektüre einer langen Dokumentation und das Befolgen repositoriespezifischer Konventionen ohne Hilfsskripte oder schnellen Installationspfad.
- Hohe thematische Eindeutigkeit: Die Beschreibung macht klar, dass es um das Erstellen eines neuen `@ai-sdk/<provider>`-Pakets im AI SDK geht.
- Substanz in der Praxis: Die Skill enthält eine ausführliche Schritt-für-Schritt-Anleitung, Codeblöcke, Architektur-Erklärungen und Dateipfad-Konventionen für die Paketerstellung.
- Vertrauenssignal mit Beleg: Es wird auf ein konkretes Pull-Request-Beispiel (`vercel/ai` PR #8136) verlinkt, das als reale Implementierungsreferenz dient.
- Passung vor allem für dieses Repository: Der Leitfaden richtet sich offenbar an Mitwirkende von `vercel/ai` und nicht allgemein an Agents, die Provider-Pakete in beliebigen Codebases hinzufügen.
- Begrenzte Unterstützung bei der Ausführung: Es gibt keine Installationsbefehle, Skripte, Hilfsdateien oder paketierten Ressourcen, die den Implementierungsaufwand und Unsicherheiten verringern.
Überblick über die add-provider-package-Skill
Die add-provider-package-Skill ist ein fokussierter Implementierungsleitfaden, um ein neues @ai-sdk/<provider>-Paket innerhalb von vercel/ai anzulegen. Sie eignet sich besonders für Maintainer, Contributors und API-Plattform-Teams, die einen Modellanbieter in das AI SDK integrieren möchten – mit der richtigen Paketstruktur, sauberer Adapter-Schichtung und im Einklang mit den Konventionen des Repositories.
Wobei add-provider-package tatsächlich hilft
Die eigentliche Aufgabe ist nicht einfach nur, „irgendetwas als Wrapper zu schreiben“. Die add-provider-package-Skill hilft dir dabei, ein Provider-Paket hinzuzufügen, das zur internen Architektur des AI SDK passt, die erwartete Provider-Oberfläche exportiert und dem Paketaufbau, der Teststrategie und den Implementierungsmustern des Repos folgt.
Für wen add-provider-package gedacht ist
Nutze die add-provider-package-Skill, wenn du:
- einen neuen Modellanbieter zum
vercel/ai-Monorepo hinzufügen willst - ein Third-Party-Provider-Paket bauen möchtest, das sich an den First-Party-Paketen orientiert
- eine externe API auf AI-SDK-Abstraktionen wie Sprachmodelle oder Embeddings abbilden willst
- einen konkreten Weg suchst, der über einen generischen „build an adapter“-Prompt hinausgeht
Besonders nützlich ist sie, wenn du die HTTP-API des Providers bereits verstehst, aber Unterstützung brauchst, um sie in die Paketkonventionen des AI SDK zu übersetzen.
Typische Einsatzfälle mit gutem Fit
Die add-provider-package-Skill ist besonders stark, wenn du:
- einen neuen Ordner
packages/<provider>mit der erwarteten Struktur anlegen musst - Provider-Klassen gegen die Interfaces aus
@ai-sdk/providerimplementieren willst - Muster aus bestehenden Providern wiederverwenden möchtest, statt eigene Konventionen zu erfinden
- vorab verstehen willst, was bei First-Party- und Third-Party-Paketen jeweils erwartet wird
Wichtige Unterschiede zu einem generischen Coding-Prompt
Ein allgemeiner Prompt kann Adapter-Code entwerfen. Wertvoller ist add-provider-package, wenn du repo-spezifische Orientierung brauchst: wo das Paket hingehört, wie die Provider-Architektur geschichtet ist, welche Dateien typischerweise dazugehören und wie ein vollständiges Provider-Paket in dieser Codebasis aussehen soll.
Wichtigste Einschränkung bei der Nutzung
Diese Skill ist bewusst eng zugeschnitten. Sie ist für die Erstellung von @ai-sdk/<provider>-Paketen gedacht – nicht für allgemeines API-SDK-Design, beliebige Wrapper oder irgendein Plugin-System. Wenn dein Ziel außerhalb der Provider-Architektur des AI SDK liegt, wird dir diese Skill wahrscheinlich zu spezifisch vorkommen.
So verwendest du die add-provider-package-Skill
Installationskontext für add-provider-package
Diese Skill liegt in vercel/ai unter skills/add-provider-package. In einem Skills-fähigen Workflow installierst du sie mit:
npx skills add vercel/ai --skill add-provider-package
Wenn deine Umgebung Repository-Skills bereits automatisch verfügbar macht, reicht es möglicherweise, die Skill nur per Namen aufzurufen.
Starte mit der einen Datei, die wirklich zählt
Lies zuerst skills/add-provider-package/SKILL.md. In diesem Repository-Snapshot steckt die zentrale Anleitung genau dort, unter anderem zu:
- Erwartungen an First-Party- vs. Third-Party-Pakete
- der geschichteten Provider-Architektur
- der Paketstruktur
- einer schrittweisen Implementierungsanleitung
- einer Referenz-PR als vollständigem Beispiel
Da hier keine zusätzlichen resources/, rules/ oder Helper-Skripte sichtbar sind, steckt der meiste praktische Mehrwert in SKILL.md plus den bereits vorhandenen Provider-Paketen an anderer Stelle im Monorepo.
Welche Eingaben add-provider-package von dir braucht
Damit die Skill brauchbare Ergebnisse liefern kann, solltest du konkrete Provider-Details angeben – nicht nur „füge Support für X hinzu“. Das Minimum an hilfreichem Input ist:
- Provider-Name und Paketziel, etwa
@ai-sdk/acme - Methode zur API-Authentifizierung
- unterstützte Modelltypen: Chat, Completion, Embeddings, Image usw.
- Streaming-Verhalten
- Request- und Response-Schemas
- Fehlerformat und Verhalten bei Rate Limits
- provider-spezifische Besonderheiten, etwa Unterschiede bei Tool Calling oder JSON Mode
Ohne diese Details kann die Skill zwar die Struktur skizzieren, den Adapter aber nicht zuverlässig passend ausformen.
Aus einem groben Ziel einen starken Prompt machen
Schwacher Prompt:
Use add-provider-package to add Acme AI to the SDK.
Stärkerer Prompt:
Use add-provider-package to scaffold a new packages/acme provider for vercel/ai. Acme uses API key auth via Authorization: Bearer <key>. It supports text generation and embeddings, with SSE streaming for text. I need the package structure, main source files, likely exports, and the mapping from Acme endpoints to AI SDK model interfaces. Show the repo files I should create first and call out any ambiguous areas I must resolve from the API docs.
Das funktioniert besser, weil die Skill dadurch genug Informationen hat, um die richtige Provider-Oberfläche auszuwählen und offene Integrationsrisiken früh sichtbar zu machen.
Empfohlener Workflow für die Nutzung von add-provider-package
Ein praxisnaher Ablauf für die add-provider-package-Nutzung sieht so aus:
- Prüfe zuerst, ob du auf ein First-Party- oder Third-Party-Paket zielst.
- Lies
SKILL.md, um Architektur und erwarteten Paketaufbau zu verstehen. - Sieh dir die verlinkte Referenz-PR an:
https://github.com/vercel/ai/pull/8136/files. - Vergleiche ein oder zwei bestehende Provider-Pakete in
packages/. - Bitte die Skill zunächst darum, deine Provider-API auf AI-SDK-Interfaces abzubilden, bevor Dateien generiert werden.
- Frage erst danach nach einem Paket-Skelett, einem Implementierungsplan und einer Test-Checkliste.
Diese Reihenfolge reduziert Nacharbeit, weil Interface-Mismatches erkannt werden, bevor Code erzeugt wird.
Welche Repository-Pfade du nach SKILL.md prüfen solltest
Für echte Implementierungsentscheidungen ist der sinnvollste nächste Leseweg meist:
skills/add-provider-package/SKILL.md- die in der Skill verlinkte Referenz-PR
- bestehende Implementierungen unter
packages/<provider>/src/*im Monorepo - gemeinsame Interfaces in
@ai-sdk/provider - Helper-Muster in
@ai-sdk/provider-utils
Die Skill beschreibt diese geschichtete Architektur ausdrücklich. Genau deshalb solltest du dort nachlesen, um generierten Code gegen die aktuellen Muster des Repos zu validieren.
Was add-provider-package besonders gut abdeckt
Der add-provider-package-Leitfaden ist besonders nützlich für:
- das Grundgerüst des Pakets
- die architektonische Passung innerhalb des AI SDK
- die Frage, welche Provider-Interfaces relevant sind
- das Verständnis, wie ein Provider als Adapter statt als individueller Client modelliert wird
- die Nutzung einer bestehenden Provider-Erweiterung als Referenzimplementierung
Was dir die Skill nicht abnimmt
Die Skill ersetzt nicht die Auslegung der Upstream-API-Dokumentation des Providers. Du musst weiterhin selbst entscheiden:
- welche Fähigkeiten echten First-Class-Support verdienen
- wie provider-spezifische Request-Optionen behandelt werden sollen
- welche Modelle exponiert werden sollen
- wie nicht standardisierte Fehler und Streaming-Payloads übersetzt werden
- ob nicht unterstützte Features weggelassen oder hinter provider-spezifischen Optionen sichtbar gemacht werden sollen
Praktische Prompt-Muster für add-provider-package in der API-Entwicklung
Wenn du add-provider-package for API Development nutzt, frage die Ergebnisse am besten in Entscheidungsreihenfolge ab:
- Capability-Mapping
- Paket-/Dateiplan
- Typ-/Interface-Plan
- Plan für Request-/Response-Transformation
- Tests und Edge Cases
Beispiel:
Use add-provider-package to plan an @ai-sdk/zen package. First, map Zen's endpoints to AI SDK interfaces. Second, propose the package file tree. Third, list the core transforms for text generation, embeddings, and streaming. Finally, list the top 10 edge cases to test.
So bekommst du ein deutlich besser umsetzbares Ergebnis, als wenn du direkt am Anfang einen kompletten Code-Dump anforderst.
Häufige Blocker vor dem eigentlichen Coding
Die größten Blocker sind meist keine Syntaxfehler, sondern fehlende Produktentscheidungen:
- Soll das ein First-Party- oder ein Third-Party-Paket werden?
- Passt die Provider-API überhaupt sauber zu den Abstraktionen des AI SDK?
- Sind die Streaming-Events stabil genug, um darauf einen Adapter aufzubauen?
- Welche Modellfähigkeiten sind reif genug, um sie freizugeben?
- Gibt es bestehende Provider, deren Form du besser kopieren solltest?
Nutze die Skill früh, um diese Fragen offenzulegen, bevor du mit dem Paketbau beginnst.
FAQ zur add-provider-package-Skill
Ist add-provider-package nur für Vercel-Maintainer gedacht?
Nein. Die Skill ist auch für externe Contributors und Autoren von Third-Party-Paketen nützlich. Die Quelle unterscheidet ausdrücklich zwischen Third-Party-Paketen und First-Party-@ai-sdk/<provider>-Paketen und weist darauf hin, dass First-Party-Erweiterungen vorab abgestimmt werden sollten.
Ist add-provider-package für Einsteiger geeignet?
Sie ist für Einsteiger nutzbar, wenn sie die API des Ziel-Providers bereits kennen, aber sie ist kein Einsteiger-Tutorial zu TypeScript, Package Publishing oder SDK-Design. Ihren größten Mehrwert liefert sie für Personen, die repo-spezifische Orientierung und architektonische Passung brauchen.
Worin unterscheidet sich das von der Frage an ein LLM, einen Provider-Wrapper zu bauen?
Ein normaler Prompt kann plausiblen Code erzeugen, ohne die Paketstruktur oder Interfaces des AI SDK sauber zu treffen. Die add-provider-package-Skill verankert die Arbeit in der Adapter-Architektur des Monorepos und verweist auf eine konkrete Referenzimplementierung.
Kann ich add-provider-package auch außerhalb des vercel/ai-Repos verwenden?
Ja, als Muster und Referenz. Aber je näher dein Projekt an den Provider-Abstraktionen und dem Paketaufbau des AI SDK liegt, desto besser lässt sich das Ergebnis übertragen. Wenn deine Codebasis andere Interfaces oder Publishing-Konventionen nutzt, musst du mit zusätzlicher Anpassungsarbeit rechnen.
Wann sollte ich add-provider-package nicht verwenden?
Lass die Skill aus, wenn du:
- einen allgemeinen API-Client baust
- einen Provider außerhalb des AI-SDK-Modells integrierst
- Frontend-App-Beispiele statt Provider-Paket-Code suchst
- nicht bereit bist, bestehende Provider-Implementierungen auf Vergleichbarkeit zu prüfen
Enthält add-provider-package ein vollständiges End-to-End-Beispiel?
Sie enthält einen Referenzverweis auf eine vollständige Provider-Erweiterung per PR: https://github.com/vercel/ai/pull/8136/files. Das ist einer der wertvollsten Teile der Skill, weil dort sichtbar wird, wie eine abgeschlossene Ergänzung im tatsächlichen Kontext aussieht.
So verbesserst du die add-provider-package-Skill
Gib add-provider-package Inputs auf Capability-Ebene
Der schnellste Hebel für bessere Ergebnisse ist eine präzise Beschreibung der Provider-Fähigkeiten. Statt nur „supports chat“ zu schreiben, liefere besser:
- Endpoint-Namen
- Streaming-Protokoll
- Unterstützung für Tool Calling
- Verhalten bei strukturierten Outputs
- Embeddings-Dimensionalität oder Request-Format
- Authentifizierung und Header
- Besonderheiten bei Retries oder Rate Limits
So kann die Skill über die Passung zu den Interfaces nachdenken, statt aus Marketingbegriffen zu raten.
Bitte vor der Code-Generierung um eine Gap-Analyse
Ein starker erster Schritt ist:
Use add-provider-package to identify the gaps between this provider API and AI SDK expectations before proposing code.
Das ist oft besser, als sofort nach Scaffolding zu fragen, weil so fehlende Features, inkompatible Streaming-Formate oder Bereiche mit Bedarf für provider-spezifische Optionen früh sichtbar werden.
Verweise auf einen ähnlichen bestehenden Provider
Wenn du einen Provider in vercel/ai kennst, der eine ähnliche API-Form hat, sag das explizit. Zum Beispiel:
Use add-provider-package and model this after the provider package that has the closest SSE text streaming and embeddings support.
Das verbessert die Konsistenz und reduziert erfundene Abstraktionen.
Fordere Datei-für-Datei-Ausgaben an, keinen riesigen Gesamtdraft
Die Skill lässt sich leichter validieren, wenn du gezielt nach Folgendem fragst:
- Paketbaum
src/index.ts-Exports- Provider-Factory
- Implementierungsdateien für Modelle
- Tests
- Paket-Metadaten
Das macht das Review deutlich verlässlicher, als ein komplettes Paket in einem einzigen Durchgang generieren zu lassen.
Häufige Fehlermuster, auf die du achten solltest
Wenn du add-provider-package verwendest, prüfe die Ergebnisse gezielt auf:
- als stabil dargestellte Fähigkeiten, die in Wahrheit nicht unterstützt werden
- zu optimistisch gemapptes Streaming
- provider-spezifische Optionen, die in generische Interfaces auslaufen
- fehlende Fehlernormalisierung
- eine Paketstruktur, die nicht zu den bestehenden Repo-Konventionen passt
- Code, der Unterschiede im Prozess zwischen First-Party und Third-Party ignoriert
Verbessere Prompts mit konkreten API-Beispielen
Wenn der erste Output zu abstrakt bleibt, ergänze echte Request- und Response-Beispiele aus der Provider-Dokumentation. Das ist einer der wirksamsten Hebel überhaupt, weil Provider-Pakete mit der Korrektheit ihrer Transformationen stehen und fallen.
Guter Follow-up-Prompt:
Here are the exact JSON request and SSE response shapes for text generation. Revise the add-provider-package plan so the model implementation and streaming parser match these payloads.
Iteriere offen über ungeklärte Entscheidungen
Bitte die Skill nach dem ersten Durchgang, Folgendes sauber zu trennen:
- belastbare Implementierungsschritte
- Annahmen
- offene Fragen, die in den Provider-Dokumenten geklärt werden müssen
- wahrscheinliche Tests
Diese Struktur macht die Skill deutlich handlungsorientierter und reduziert versteckte Mutmaßungen.
Beste Methode, um add-provider-package-Output zu validieren
Behandle das Ergebnis als repo-bewussten Implementierungsplan und gleiche ihn dann ab mit:
SKILL.md- der verlinkten Referenz-PR
- ein oder zwei bestehenden Provider-Paketen
- den Interfaces aus
@ai-sdk/provider - der offiziellen API-Dokumentation des Ziel-Providers
Dieser Validierungs-Loop ist der beste Weg, um die add-provider-package-Nutzung von einem „hilfreichen Entwurf“ zu einem Paket zu bringen, das du tatsächlich mergen oder veröffentlichen kannst.