netlify-config

Überblick über die netlify-config-Skill

Wofür netlify-config gedacht ist

Die netlify-config-Skill ist eine praktische Referenz zum Schreiben und Anpassen von netlify.toml. Verwenden Sie die netlify-config-Skill, wenn Sie Builds, Redirects, Rewrites, Header, Deploy-Kontexte, Umgebungsvariablen, Functions oder Edge Functions konfigurieren müssen, ohne die Netlify-Syntax zu raten.

Für wen sie geeignet ist

Sie eignet sich am besten für Builder, die bereits wissen, was Netlify tun soll, aber eine verlässliche Methode brauchen, um es korrekt auszudrücken. Der netlify-config-Leitfaden ist besonders nützlich für Deployment-Änderungen, die leicht subtil falsch werden, etwa die Reihenfolge von Redirects, Catch-all-Routing oder kontextspezifische Einstellungen.

Was sie nützlich macht

Diese Skill konzentriert sich auf die Konfigurationsdetails, die das tatsächliche Deploy-Verhalten beeinflussen: Dateipfad, TOML-Struktur, Regel-Matching und Netlify-spezifische Optionen wie Bedingungen und Force-Regeln. Wenn Sie zwischen einem einfachen Prompt und der netlify-config-Skill wählen, ist die Skill besser, wenn Korrektheit wichtiger ist als Ideenfindung.

So verwenden Sie die netlify-config-Skill

Skill installieren und laden

Nutzen Sie den netlify-config-Installationsablauf in Ihrem Skills-Workflow und öffnen Sie dann skills/netlify-config/SKILL.md als Ausgangspunkt. Das Repository präsentiert die Skill derzeit als Ein-Datei-Referenz, es gibt also keine Hilfsskripte oder Begleitressourcen, denen Sie hinterherlaufen müssen.

Formulieren Sie aus Ihrem Ziel einen brauchbaren Prompt

Die beste Nutzung von netlify-config beginnt mit einem konkreten Deployment-Ziel, nicht mit einer vagen Anfrage. Ein guter Input nennt den Site-Typ, die Datei, die Sie bearbeiten, und das gewünschte Ergebnis. Zum Beispiel: „Aktualisiere netlify.toml, sodass /docs/* in Production zu /docs/index.html umschreibt, aber /api/* in allen Deploy-Kontexten weiter zum Backend proxyt.“

Lesen Sie zuerst die richtigen Stellen

Beginnen Sie mit den Beispielen für Build-Einstellungen und Redirects und prüfen Sie dann die Abschnitte, die zu Ihrer Änderung passen: Header, Deploy-Kontexte, Functions oder Edge Functions. In der Praxis ist der schnellste Weg, netlify-config für Deployment zu nutzen, Ihr gewünschtes Routing-Verhalten dem nächstliegenden Beispiel zuzuordnen und dann die Syntax anzupassen, statt sie von Grund auf neu zu erfinden.

Tipps für bessere Ergebnisse

Geben Sie der Skill den aktuellen Dateipfad, das Output-Verzeichnis des Frameworks und alle bereits vorhandenen Konfliktregeln. Erwähnen Sie, ob Sie einen Rewrite, einen Redirect oder einen Proxy brauchen, denn diese Entscheidungen verändern den richtigen status-Wert und ob force nötig ist. Wenn Sie in einem Monorepo arbeiten, nennen Sie das Basisverzeichnis ausdrücklich, damit die Konfiguration am richtigen Ort landet.

FAQ zur netlify-config-Skill

Ist netlify-config nur für netlify.toml gedacht?

Ja, die netlify-config-Skill ist auf netlify.toml und das damit gesteuerte Deployment-Verhalten ausgerichtet. Wenn Ihr Problem eine breitere Netlify-Hosting-Strategie betrifft, hilft diese Skill trotzdem, wenn die Kernaufgabe Konfigurationssyntax oder Regel-Design ist.

Wann reicht ein normaler Prompt aus?

Ein normaler Prompt reicht für grobe Ideen wie „Wie funktionieren Netlify-Redirects?“. Die netlify-config-Skill ist besser, wenn Sie eine deploy-bereite Antwort brauchen, besonders bei Routing-Prioritäten, Rewrites oder kontextspezifischen Einstellungen, bei denen kleine Syntaxfehler zu kaputten Builds führen.

Ist sie anfängerfreundlich?

Ja, wenn Sie Ihr Deployment-Ziel in einfacher Sprache beschreiben können. Die größte Hürde ist nicht die Schwierigkeit der Skill, sondern unvollständige Eingabe. Anfänger erzielen bessere Ergebnisse, wenn sie den aktuellen Build-Befehl, den Publish-Ordner und die Pfadmuster angeben, die geändert werden sollen.

Wann sollte ich sie nicht verwenden?

Verwenden Sie netlify-config nicht, wenn Sie noch zwischen Plattformen wählen oder nicht wissen, ob die Änderung in Redirects, Headern oder Build-Einstellungen gehört. Es ist eine Konfigurations-Skill, kein allgemeiner Netlify-Erklärer und kein Berater für Site-Architektur.

So verbessern Sie die netlify-config-Skill

Beschreiben Sie das konkrete Routing-Problem

Die stärksten Ergebnisse der netlify-config-Skill entstehen durch präzise Pfadbeispiele. Statt „Redirects reparieren“ geben Sie den alten Pfad, den Zielpfad, den gewünschten Statuscode und eventuelle Ausnahmen an. So kann die Skill ohne Mehrdeutigkeit zwischen 301, 302, 200 und 404 wählen.

Fügen Sie Deploy-Kontext und Einschränkungen hinzu

Bei netlify-config für Deployment ist Kontext entscheidend: Verhalten nur in Production, Unterschiede bei Preview-Deploys und umgebungsspezifische Variablen ändern die richtige Antwort. Sagen Sie, ob die Regel global gelten soll oder nur in einem Deploy-Kontext, und nennen Sie vorhandene CMS-, SPA- oder API-Einschränkungen.

Bitten Sie um die fertige Datei, nicht nur um Rat

Eine hilfreiche Anfrage an den netlify-config-Leitfaden sollte nach dem exakten netlify.toml-Snippet fragen, das Sie direkt einfügen können, plus einer kurzen Notiz dazu, wo es in der Datei stehen soll. Das reduziert Rückfragen und macht es leichter, Reihenfolgefehler vor dem Deploy zu erkennen.

Iterieren Sie ab dem ersten Deployment-Test

Nachdem die erste Konfiguration geschrieben wurde, testen Sie das echte Pfadverhalten und verfeinern Sie es anhand dessen, was Netlify tatsächlich ausliefert. Häufige Fehlerbilder sind verdeckte Regeln, fehlendes force = true und die Verwechslung von Redirects mit Rewrites; der nächste Prompt sollte das beobachtete Verhalten beschreiben, nicht nur das beabsichtigte.