Automatisierung
Netlify Deploy
Automatisiertes Deployment von Webprojekten auf Netlify per CLI
Redaktion: Josef Wilhelm · Zuletzt geprüft am
Dieser Skill übernimmt den kompletten Deployment-Ablauf für Netlify direkt über die offizielle Netlify-CLI (npx netlify), ohne dass eine globale Installation nötig ist. Er prüft zunächst den Anmeldestatus, führt bei Bedarf durch den Login-Prozess per Browser-OAuth oder Access-Token und stellt fest, ob das aktuelle Projekt bereits mit einer Netlify-Site verknüpft ist. Fehlt die Verknüpfung, versucht er sie über den Git-Remote herzustellen oder legt mit netlify init eine neue Site an.
Nach erfolgreicher Verknüpfung erkennt der Skill Build-Konfiguration und Framework – etwa anhand einer vorhandenen netlify.toml oder typischer Defaults für Next.js, Vite oder statisches HTML – und installiert fehlende Abhängigkeiten vor dem eigentlichen Deploy. Er unterscheidet zwischen Preview-Deploys zum Testen und Produktions-Deploys mit --prod und liefert im Anschluss Deploy-URL sowie Hinweise zu Logs und nächsten Schritten. Zusätzlich enthält er Troubleshooting-Hinweise für häufige Fehlerfälle wie fehlende Authentifizierung, blockierte Netzwerkzugriffe im Sandbox-Betrieb oder fehlgeschlagene Builds.
Quelle: GitHub-Repository openai/skills · SKILL.md des Skills
Praxistest
Unser Test: Netlify Deploy im Einsatz
- Datum
- Werkzeug
- Claude Code 2.1.291 (Modell laut Sitzungsprotokoll: claude-opus-5-5)
- Aufgabe
- Wir haben ein kleines Vite-React-Projekt ohne Netlify-Konfiguration angelegt. Aufgabe: Bereite alles für die Veröffentlichung auf Netlify vor, was ohne Login geht, und nenne die Befehle, die ich danach selbst ausführe. Selbst Befehle ausführen durfte Claude Code nicht.
- Ergebnis
- Claude Code hat den Skill aufgerufen, das Projekt gelesen, die Referenzdatei zur netlify.toml geöffnet und eine netlify.toml angelegt: Build-Befehl npm run build, Ausgabeordner dist und eine feste Node-Version. Danach nennt die Antwort die Befehle in dieser Reihenfolge: npm install, npm run build, npx netlify login, npx netlify sites:create, Vorschau-Deploy mit npx netlify deploy --build, dann live mit --prod. Sie begründet, warum sie sites:create statt init empfiehlt: Das Projekt ist kein Git-Repository.
- Grenzen
- Den Kern des Skills, den echten Deploy, haben wir nicht getestet. Er braucht ein Netlify-Konto und einen Login, und wir haben bewusst keine Befehle und keine Skripte ausgeführt. Ob die erzeugte netlify.toml auf Netlify wirklich baut, ist ungeprüft. Der Test zeigt nur die Vorbereitung.
- Dauer
- 22 Sekunden
Skripte des Skills haben wir dabei nicht ausgeführt. Der Skill lag nur als Textdateien im Projektordner, und Claude Code hatte kein Bash.
FAQ
Häufige Fragen zu Netlify Deploy
- Muss die Netlify-CLI vorher installiert werden?
- Nein, der Skill nutzt die CLI über npx netlify, eine globale Installation ist nicht erforderlich. Vorausgesetzt wird lediglich ein Netlify-Account mit aktiver Anmeldung sowie ein gültiges Webprojekt im aktuellen Verzeichnis.
- Wie funktioniert die Anmeldung bei Netlify?
- Der Skill prüft zunächst den Status mit npx netlify status und führt bei Bedarf durch den Login per Browser-OAuth. Alternativ lässt sich die Anmeldung über einen Access-Token setzen, der als Umgebungsvariable NETLIFY_AUTH_TOKEN hinterlegt wird.
- Was passiert, wenn das Projekt noch nicht mit Netlify verknüpft ist?
- Der Skill versucht zuerst, die Site über den Git-Remote automatisch zu verknüpfen. Schlägt das fehl, weil noch keine passende Site existiert, wird per netlify init eine neue Site interaktiv angelegt, inklusive Team-Auswahl und Build-Konfiguration.
- Funktioniert das Deployment auch in Sandbox-Umgebungen mit eingeschränktem Netzwerkzugriff?
- Laut Beschreibung kann es vorkommen, dass Sandbox-Netzwerkbeschränkungen ausgehende Deployment-Anfragen blockieren. In diesem Fall enthält der Skill Hinweise, den Vorgang mit erweiterten Netzwerkrechten (sandbox_permissions=require_escalated) erneut auszuführen.