netlify-deploy

Überblick über netlify-deploy

netlify-deploy ist ein Deployment-orientierter Skill, mit dem Webprojekte über die Netlify CLI auf Netlify veröffentlicht werden. Er eignet sich besonders für Nutzer, die einen wiederholbaren Weg von einem lokalen Repo zu einem Preview- oder Production-Deploy brauchen, vor allem dann, wenn das Projekt zuerst noch verknüpft, initialisiert oder authentifiziert werden muss.

Der netlify-deploy Skill ist am nützlichsten, wenn die Aufgabe nicht nur „Deploy ausführen“ lautet, sondern „den richtigen Netlify-Workflow für dieses Repo finden“. Dazu gehört zu erkennen, ob die Site bereits verknüpft ist, zwischen Preview und Production zu entscheiden und von netlify.toml gesteuerte Build-Einstellungen zu berücksichtigen.

Wofür dieser Skill gedacht ist

Verwende den netlify-deploy Skill, wenn du Folgendes tun willst:

• eine lokale Web-App, statische Site oder Framework-App auf Netlify deployen
• für ein neues Projekt den ersten Deploy erstellen
• ein vorhandenes Git-Repo oder einen lokalen Ordner mit einer bestehenden Netlify-Site verknüpfen
• vor dem Go-live erst einen Preview-Deploy erzeugen

Was ihn unterscheidet

Der Hauptwert von netlify-deploy liegt in der Workflow-Führung, nicht bloß in einer Befehlsliste. Der Skill stellt die Netlify CLI in den Mittelpunkt, prüft zuerst die Authentifizierung und berücksichtigt typische Blocker wie eine nicht verknüpfte Site, ein fehlendes Publish-Verzeichnis oder eine unvollständige Build-Konfiguration.

Wann er am besten passt

Der Skill passt zu Nutzern, die bereits ein echtes Projektverzeichnis haben und einen verlässlichen Deploy-Pfad suchen. Für abstrakte Fragen wie „Wie benutze ich Netlify?“ ist er weniger hilfreich, außer die Person ist bereit, direkt mit einem konkreten Repo zu arbeiten.

So verwendest du den netlify-deploy Skill

Zuerst den Skill installieren und lesen

Für netlify-deploy install solltest du beim Skill-Eintrag selbst beginnen und dann die unterstützenden Referenzen lesen, die die Befehlswahl steuern:

• SKILL.md
• references/cli-commands.md
• references/deployment-patterns.md
• references/netlify-toml.md

Hier gibt es keine Skript-Schicht, daher steckt die wichtigste Entscheidungshilfe in den Referenzen. Lies zuerst deployment-patterns.md, wenn du Hilfe bei der Wahl zwischen Login, Link, Init, Preview-Deploy und Production-Deploy brauchst.

Eine vage Aufgabe in einen brauchbaren Prompt übersetzen

Der Skill funktioniert am besten, wenn der Nutzer den Repo-Zustand und das Deployment-Ziel klar benennt. Ein starker netlify-deploy usage Prompt enthält:

• Framework oder Build-Tool, falls bekannt
• ob die Site auf Netlify bereits existiert
• ob das Ziel ein Preview oder Production-Deploy ist
• das erwartete Build-Output-Verzeichnis, falls bekannt
• ob netlify.toml bereits vorhanden ist

Beispiel:
„Deploy diese Vite-App auf Netlify. Sie ist noch nicht verknüpft, ich möchte einen Production-Deploy, und der Build-Output ist dist.“

Schwacher Input:
„Deploy meine Site.“

Empfohlener Workflow

Ein praxistauglicher netlify-deploy guide Ablauf ist:

1. Authentifizierung mit npx netlify status prüfen.
2. Falls nötig mit npx netlify login anmelden.
3. Entscheiden, ob eine bestehende Site verknüpft oder mit npx netlify link bzw. npx netlify init eine neue angelegt werden soll.
4. Build-Output und Konfiguration in netlify.toml bestätigen.
5. Für Preview npx netlify deploy ausführen oder für Production npx netlify deploy --prod.

Konfigurationsdateien nutzen, um Rätselraten zu vermeiden

Prüfe vor dem Deploy netlify.toml, falls die Datei existiert. Die wichtigsten Felder sind build.command, build.publish und alle umgebungsspezifischen Einstellungen. Wenn der Publish-Pfad nicht zum tatsächlichen Build-Output passt, kann der Deploy zwar durchlaufen, aber das falsche Verzeichnis ausliefern oder bei der Validierung scheitern.

FAQ zum netlify-deploy Skill

Ist netlify-deploy nur für Nutzer der Netlify CLI?

Ja. Der Skill ist auf npx netlify und den CLI-Workflow ausgerichtet. Wenn du lieber nur über das Dashboard deployen willst, ist das wahrscheinlich nicht die richtige Wahl.

Muss das Projekt schon verknüpft sein, um ihn zu nutzen?

Nein. Der netlify-deploy skill deckt sowohl die Erstkonfiguration als auch bestehende Sites ab. Wenn das Repo noch nicht verknüpft ist, sollte der Workflow vor dem Deploy auf link oder init umstellen.

Ist das besser als ein generischer Deploy-Prompt?

Meistens ja, weil netlify-deploy die echte Netlify-Reihenfolge einbaut: authentifizieren, verknüpfen oder initialisieren, Konfiguration prüfen und dann deployen. So sinkt die Wahrscheinlichkeit, einen nötigen Vorbereitungsschritt zu überspringen, der den Deploy blockiert.

Wann sollte ich ihn nicht verwenden?

Verwende netlify-deploy nicht, wenn es sich nicht um eine Web-App handelt, wenn du keine CLI-Befehle ausführen kannst oder wenn du eher einen allgemeinen Hosting-Vergleich als einen Netlify-spezifischen Workflow brauchst.

So verbesserst du den netlify-deploy Skill

Gib dem Skill die Repo-Fakten, die den Deploy-Pfad ändern

Die größten Qualitätsgewinne entstehen, wenn du die Informationen nennst, die der Skill nicht sicher ableiten kann:

• Framework: Next.js, Astro, Vite, SvelteKit usw.
• Build-Befehl: npm run build, pnpm build oder ein eigener Befehl
• Publish-Verzeichnis: dist, build, .next oder ein anderes
• Site-Status: neu, verknüpft oder bereits deployt
• Ziel: Preview oder Production

Diese Angaben helfen dem netlify-deploy Skill, ohne Trial-and-Error den richtigen CLI-Pfad zu wählen.

Konfigurationsabweichungen früh sichtbar machen

Ein häufiger Fehler ist die Annahme, Netlify würde alles korrekt erkennen. Wenn deine App ein unübliches Output-Verzeichnis, ein Monorepo-Layout oder einen benutzerdefinierten Base Path verwendet, nenne das direkt und verweise den Skill auf netlify.toml. Das ist besonders wichtig für netlify-deploy for Deployment in Monorepos oder bei framework-spezifischen Builds.

Nach der Form des ersten Deploys fragen, nicht nur nach dem Befehl

Bessere Ergebnisse bekommst du, wenn du eine Ausgabe anforderst, die die Abfolge enthält, nicht nur eine einzelne Zeile. Zum Beispiel:
„Zeig mir die genauen Schritte, um mich anzumelden, dieses Repo zu verknüpfen, netlify.toml zu prüfen und in Production zu deployen.“

So wird der Skill dazu angeregt, die Entscheidungspunkte zu erklären, die vor dem eigentlichen Deploy-Befehl wichtig sind.

Auf Basis des ersten Deploy-Ergebnisses iterieren

Wenn der erste Deploy fehlschlägt, gib den konkreten Fehler und das aktuelle Dateilayout zurück, statt die Anfrage von vorne zu wiederholen. Besonders hilfreiche Folgeeingaben sind:

• die Fehlermeldung von npx netlify
• der Inhalt von netlify.toml
• das von deinem Framework tatsächlich erzeugte Build-Output-Verzeichnis
• ob die Site vor dem Fehler bereits verknüpft war

So wird der nächste netlify-deploy usage Schritt präziser und du vermeidest es, Authentifizierung oder Verknüpfungsschritte zu wiederholen, die bereits funktioniert haben.