update-provider-models
von vercelupdate-provider-models unterstützt beim Aktualisieren von Provider-Modell-IDs in vercel/ai. Nutze die Skill, um neue Modelle hinzuzufügen oder veraltete zu entfernen – mit Exakttreffer-Suche, Prüfungen der Reihenfolge und vollständigen Codebase-Updates über alle betroffenen Dateien hinweg.
Diese Skill erreicht 78/100 und ist damit ein solider Verzeichniseintrag für Nutzer, die Modellkataloge innerhalb des Vercel AI SDK pflegen. Der Umfang ist klar auf das Hinzufügen und Entfernen von Provider-Modell-IDs begrenzt, enthält Trigger-Formulierungen sowie Workflow-Hinweise und hilft einem Agenten, mit weniger Interpretationsspielraum zu arbeiten als ein generischer Prompt. Nutzer sollten jedoch weiterhin von einem rein dokumentationsbasierten Workflow ausgehen, ohne mitgelieferte Automatisierung oder installationsspezifische Setup-Hilfe.
- Klare Auslösbarkeit: Die Beschreibung zielt ausdrücklich auf Anfragen wie "add model", "remove model", "new model ID" und ähnliche Formulierungen ab.
- Operativ nützlich: Die Skill definiert getrennte Workflows für das Hinzufügen und Entfernen von Modell-IDs und nennt konkrete Regeln wie Exaktabgleich, das Beibehalten der Sortierreihenfolge und sequenzielle Verarbeitung.
- Am Repository ausgerichtete Anleitung: Sie verweist auf die Suche in der Codebase und auf betroffene Provider-Paketpfade, was Agenten echte Ausführungsorientierung über allgemeine Hinweise hinaus gibt.
- Es sind keine unterstützenden Dateien oder Skripte enthalten. Die Ausführung hängt daher davon ab, dass der Agent den textlichen Anweisungen korrekt folgt, statt paketierte Automatisierung auszuführen.
- In SKILL.md gibt es weder einen Installationsbefehl noch eine Quickstart-Setup-Anleitung, was die unmittelbare Nutzbarkeit für Verzeichnisnutzer einschränkt.
Überblick zum Skill update-provider-models
Was update-provider-models macht
Der Skill update-provider-models ist ein fokussierter Wartungs-Workflow, um neue Modell-IDs hinzuzufügen oder veraltete zu entfernen – innerhalb der Vercel AI SDK Codebase. Er ist für Code-Editing-Aufgaben gedacht, bei denen ein simples „update the models“ zu riskant wäre, weil Modell-IDs oft in mehreren Packages, typisierten Listen, Tests und Beispielen auftauchen.
Für wen dieser Skill geeignet ist
Dieser update-provider-models skill eignet sich besonders für Mitwirkende, die an Provider-Support in vercel/ai arbeiten, für Maintainer, die Provider-Modelländerungen aus Issues umsetzen, und für Agents, die Modelllisten anpassen sollen, ohne sekundäre Update-Stellen zu übersehen.
Der eigentliche Job-to-be-done
In der Praxis geht es meist um mehr als einen einzelnen String-Ersatz. Die eigentliche Aufgabe besteht darin, alle exakten Referenzen eines Modells zu finden, das richtige Provider-Package und gemeinsam genutzte Oberflächen zu aktualisieren, die Sortierung beizubehalten, Substring-Fehler zu vermeiden und eine Modelländerung vollständig abzuschließen, bevor die nächste beginnt.
Warum update-provider-models besser ist als ein generischer Edit-Prompt
Der Hauptnutzen von update-provider-models for Code Editing liegt darin, Rätselraten zu vermeiden. Der Skill liefert einen Workflow mit klaren Vorgaben wie exakter Suche, sequentieller Bearbeitung bei mehreren Modellen und Namensregeln für Beispiele. Das ist wichtig, weil Fehler hier meist subtil sind: falsche Provider-Oberfläche, kaputte alphabetische Reihenfolge oder versehentliche Änderungen an ähnlich benannten Modellen.
Gute und schlechte Einsatzfälle für update-provider-models
Verwende ihn, wenn:
- du eine neue Modell-ID zu einem bestehenden Provider hinzufügen willst
- du eine veraltete Modell-ID entfernen musst
- du ein Provider-Issue mit mehreren Modell-Ergänzungen oder -Entfernungen abarbeitest
Erwarte nicht, dass der Skill eine neue Provider-Integration von Grund auf entwirft. update-provider-models dient dazu, bestehende Modell-Inventare von Providern zu aktualisieren – nicht dazu, eine neue Adapter-Architektur zu bauen.
So verwendest du den Skill update-provider-models
So installierst du update-provider-models
Ein praktikabler update-provider-models install-Befehl ist:
npx skills add vercel/ai --skill update-provider-models
Wenn deine Umgebung installierte Skills bereits verfügbar macht, kannst du ihn danach aufrufen, indem du den Skill-Namen angibst und die konkrete Provider- sowie Modelländerungsanfrage übergibst.
Welche Eingaben der Skill braucht
Der Skill funktioniert am besten, wenn du Folgendes angibst:
- den Provider-Namen
- ob jedes Modell hinzugefügt oder entfernt werden soll
- exakte Modell-IDs
- die Quelle der Wahrheit, etwa ein Issue, Changelog oder die Provider-Dokumentation
- ob es sich um eine einzelne Änderung oder ein Batch handelt
Schwache Eingabe:
- „Update OpenAI models“
Starke Eingabe:
- „Use
update-provider-modelsto addgpt-4.1-minito the existing provider model lists and examples invercel/ai. Check all exact matches only, preserve existing ordering, and show me every file changed.”
So machst du aus einer groben Anfrage einen starken Prompt
Ein guter Prompt für die update-provider-models usage enthält in der Regel Scope, Validierung und Erwartungen an die Ausgabe:
Use update-provider-models for Code Editing in vercel/ai.
Provider: [provider name]
Changes:
- add [exact-model-id]
- remove [exact-model-id]
Requirements:
- search for exact matches only
- update all relevant provider and shared locations
- preserve current sort/order conventions
- if examples are needed, use kebab-case filenames
- process one model completely before starting the next
- summarize why each file changed
Dieses Format reduziert den häufigsten Fehlerfall: partielle Änderungen, bei denen eine Liste aktualisiert wird, aber ein anderes Package oder ein Test übersehen wird.
Was du im Repository zuerst lesen solltest
Starte mit:
skills/update-provider-models/SKILL.md
Da die Repository-Hinweise auf einen Single-File-Skill deuten, ist SKILL.md nicht nur eine Übersicht, sondern die operative Spezifikation. Lies zuerst den Abschnitt „Critical Rules“, danach die Workflows zum Hinzufügen und Entfernen.
Die wichtigsten Workflow-Regeln für update-provider-models
Der Upstream-Skill betont einige Regeln, die die Ausgabequalität spürbar beeinflussen:
- nutze exaktes Matching, weil Modell-IDs Teilstrings anderer IDs sein können
- halte die bestehende Sortierreihenfolge in Arrays, Unions und Tabellen ein
- verwende für Beispiele
kebab-case-Dateinamen, wobei Punkte durch Bindestriche ersetzt werden - bearbeite Anfragen mit mehreren Modellen sequentiell, also immer einen vollständigen Workflow nach dem anderen
- aktualisiere sowohl das primäre Provider-Package als auch zugehörige AI SDK-Oberflächen, wenn nötig
Genau diese Details gehen in einem generischen Prompt oft verloren.
So gehst du mit Add- und Remove-Anfragen um
Bei Ergänzungen solltest du die Aufgabe als Kombination aus Auffinden und Einfügen behandeln:
- identifiziere das exakte Provider-Package und alle Oberflächen mit Modelllisten
- finde die richtige Einfügestelle, sodass die bestehende Reihenfolge erhalten bleibt
- aktualisiere bei Bedarf zugehörige Beispiele oder Dokumentationsmuster, falls das der Repository-Konvention entspricht
Bei Entfernungen solltest du die Aufgabe als Cleanup behandeln:
- bestätige, dass das Modell tatsächlich obsolet ist, und arbeite nur mit der exakten ID
- entferne Referenzen, ohne ähnlich benannte Modelle anzufassen
- prüfe, ob Beispiele, Tests oder typisierte Unions die ID noch erwähnen
So verarbeitest du ein Batch sicher
Der Skill bevorzugt ausdrücklich eine sequentielle Verarbeitung. Wenn ein Issue viele Modelländerungen enthält, schließe erst den vollständigen Workflow für ein Modell ab, bevor du mit dem nächsten beginnst. So vermeidest du vermischte Diffs und erkennst leichter, ob eine Datei übersehen wurde, solange der Suchkontext noch eng ist.
Praktische Suchstrategie, die schlechte Änderungen vermeidet
Wenn du update-provider-models verwendest, solltest du dich nicht allein auf eine naive Substring-Suche verlassen. Suche nach exakten Strings und prüfe dann jeden Treffer, um sicherzustellen, dass er wirklich dasselbe Modell im selben Provider-Kontext betrifft. Das ist wichtig bei Namen wie grok-3 und grok-3-mini, bei denen ein schneller Replace gültige benachbarte Einträge beschädigen kann.
Woran gutes Output bei update-provider-models erkennbar ist
Ein starkes Ergebnis aus dem update-provider-models guide sollte enthalten:
- alle relevanten Dateien wurden aktualisiert, nicht nur eine offensichtliche Liste
- korrekte Reihenfolge innerhalb jeder bearbeiteten Struktur
- keine versehentlichen Änderungen an ähnlichen Modell-IDs
- eine klare Zusammenfassung der Ergänzungen oder Entfernungen pro Datei
- Confidence-Checks oder Hinweise, wo Mehrdeutigkeiten geblieben sind
Wann update-provider-models am meisten Zeit spart
Dieser Skill ist besonders wertvoll, wenn:
- dieselbe Modell-ID in mehreren typisierten Oberflächen vorkommt
- du unter Zeitdruck aus einem Provider-Update-Issue heraus arbeitest
- du die Aufgabe an einen Agent mit klaren Guardrails delegierst
- der Provider viele ähnlich benannte Modellvarianten hat
FAQ zum Skill update-provider-models
Ist update-provider-models nur für vercel/ai?
Er wurde für die Struktur und Konventionen des Repositories vercel/ai geschrieben. Du kannst den Workflow auch anderswo anpassen, aber der Einsatz mit der höchsten Verlässlichkeit ist das Aktualisieren von Modell-IDs in genau dieser Codebase.
Ist das besser, als einen Agent einfach „search and replace“ machen zu lassen?
Ja, wenn Korrektheit wichtig ist. Der update-provider-models skill ist auf repository-spezifische Risiken ausgelegt: Exact-Match-Prüfung, Listenreihenfolge, Updates über mehrere Oberflächen hinweg und sequentielle Verarbeitung. Ein generischer Prompt arbeitet vielleicht schneller, übersieht aber eher abhängige Dateien oder beschädigt ähnlich benannte Einträge.
Ist update-provider-models anfängerfreundlich?
Ja, sofern du dich bereits in einem Repository bewegen und Diffs prüfen kannst. Der Workflow ist eng abgegrenzt und konkret. Einsteiger müssen trotzdem den Provider-Scope verifizieren und Suchergebnisse sorgfältig prüfen – besonders bei fast identischen Modellnamen.
Kann ich update-provider-models für einen komplett neuen Provider verwenden?
In der Regel nein. Das ist nicht das richtige erste Werkzeug, um ein Provider-Package von Grund auf neu anzulegen. update-provider-models ist dafür gedacht, Modell-IDs in einer bestehenden Provider-Integration zu aktualisieren.
Was ist, wenn ich nur ein Provider-Issue habe, aber keine exakte Dateiliste?
Das ist ein normaler und passender Anwendungsfall. Der Skill geht davon aus, dass du betroffene Stellen über die Suche identifizierst. Gib einfach die exakten Modell-IDs an und ob jede davon hinzugefügt oder entfernt werden soll.
Wann sollte ich update-provider-models nicht verwenden?
Verzichte darauf, wenn es bei der Anfrage eigentlich um Folgendes geht:
- Entwurf einer Provider-Architektur
- Änderungen an Modellfähigkeiten oder Verhaltenslogik, die nichts mit IDs zu tun haben
- umfangreiche Doku-Überarbeitungen ohne Code-Änderungen
- spekulative Updates, bei denen die Modellnamen noch nicht bestätigt sind
So verbesserst du den Skill update-provider-models
Gib exakte Modell-IDs und eine belastbare Quelle an
Der schnellste Weg, die Ergebnisse von update-provider-models zu verbessern, ist die Angabe exakter Modell-Strings plus Provider-Ankündigung, Doku-Seite oder Issue-Link als Quelle. So kann der Agent bestätigte IDs von bloßen Vermutungen unterscheiden.
Nenne das Provider-Package explizit
Wenn du den betroffenen Provider schon kennst, sag es direkt. „Add model-x“ ist schwächer als „Add model-x to the Anthropic provider surfaces in vercel/ai.“ Das reduziert False Positives und unnötige Suchläufe.
Bitte um eine Änderungszusammenfassung pro Datei
Eine der wirksamsten Maßnahmen für bessere Ausgabequalität ist die Bitte um eine kurze Begründung pro geänderter Datei. Das erleichtert das Review und legt unvollständige Arbeit schnell offen – besonders dann, wenn eine erwartete Oberfläche fehlt.
Erzwinge Exact-Match-Validierung im Prompt
Nimm eine Anweisung auf wie:
- „Verify every search hit is an exact model match, not a substring variant.”
Damit zielst du direkt auf das größte Korrektheitsrisiko in diesem Repository.
Verlange Sortierungsprüfungen nach den Änderungen
Da der Skill davon abhängt, bestehende Sortierkonventionen beizubehalten, solltest du den Agent ausdrücklich bitten, die Reihenfolge nach Einfügen oder Löschen nochmals zu prüfen. So werden schwer sichtbare Fehler abgefangen, die im Diff-Review oft durchrutschen.
Bearbeite Multi-Model-Updates einzeln
Bei Batch-Issues solltest du den Agent anweisen, ein Modell vollständig abzuschließen, bevor das nächste beginnt. So bleibt der Suchkontext präzise, und Review oder Rollback werden deutlich einfacher.
Bitte um Prüfung auf übersehene Oberflächen
Eine starke Folgeanweisung ist:
- „After edits, do one final search for the exact model ID to confirm no outdated references remain and no unintended references were changed.”
Dieser letzte Suchdurchlauf erhöht das Vertrauen in das Ergebnis spürbar.
Häufige Fehlerbilder bei update-provider-models
Typische Probleme bei der update-provider-models usage sind:
- versehentliche Bearbeitung von Substring-Treffern
- ein Modell wird in einer Liste ergänzt, aber nicht in allen erforderlichen Oberflächen
- alphabetische oder repository-spezifische Reihenfolge wird beschädigt
- Beispiel-Dateien werden bei Punkten im Namen falsch benannt
- mehrere Modell-Updates werden in einem unübersichtlichen Durchgang vermischt
So iterierst du nach dem ersten Entwurf
Wenn die erste Ausgabe unvollständig wirkt, solltest du nicht mit einer vagen Bitte nachfassen. Fordere stattdessen einen gezielten zweiten Durchlauf an:
- „Re-run update-provider-models for
model-idand verify all exact matches across provider package, shared types, tests, and examples. List any files considered but intentionally unchanged.”
So eine Iteration ist deutlich wirkungsvoller als ein schlichtes „double-check this“.
Eine praktische Review-Checkliste
Vor dem Merge solltest du prüfen:
- der Provider ist korrekt
- jede Änderung an der Modell-ID ist exakt
- die Reihenfolge entspricht weiterhin den lokalen Konventionen
- Beispiele oder Tests folgen bei Ergänzungen den Dateinamensregeln
- nach Entfernungen sind keine veralteten Referenzen mehr vorhanden
Dieses Review-Muster ist der verlässlichste Weg, um mit update-provider-models for Code Editing Ergebnisse mit hoher Sicherheit zu bekommen.