Communitygithub.com

Shader Art Coding

Schreibt, debuggt und art-direktioniert prozedurale GLSL Fragment-Shader (Shadertoy mainImage, WebGL2 / GLSL ES 3.00). Enthält eine geprüfte GLSL-Bibliothek mit Bundler und Checker.

Was ist Shader Art Coding?

Dieses Skill ist für KI-Agenten gedacht, die GLSL-Shader entwickeln oder optimieren müssen. Es deckt Shadertoy/WebGL2-Konventionen ab und bietet einen klaren Workflow: von der Zielbilddefinition über die Modellauswahl (SDF Raymarching, Höhenfeld-Marching, Volumenintegration) bis zur Bündelung und Überprüfung des Codes. Die mitgelieferte GLSL-Bibliothek enthält geprüfte Bausteine, die via Skript durchsucht und automatisch in den finalen Shader eingebunden werden. Das Skill setzt strenge Regeln für die GLSL ES 3.00-Kompatibilität (keine `#version`-Angabe, keine Sinus-Hashes) und unterstützt Debug-Ansichten sowie eine lineare Farbpipeline. Es eignet sich besonders für prozedurale Texturen, generative Grafiken, Gebäude-/Stadtgenerierung, Terrain, Ozean/Küstenwasser, Wolken und andere volumetrische Effekte, sowie für PBR-Beleuchtung und Farbtonemapping.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LyalinDotCom/gemini-shader-test-carbon/tree/main/shader-skills/skills/shader-art-coding

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Shader Art Coding?

Behandele Shader-Arbeit als visuelle Ingenieurskunst: Beginne mit dem angestrebten Bild, wähle das kleinste mathematische Modell, das es erzeugen kann, baue es in überprüfbaren Schritten auf und verifiziere jeden Schritt mit einer Debug-Ansicht.

Arbeitsablauf

  1. Ziel. Beschreibe das Bild: Motiv, Kamera und Bildausschnitt, dominante Formen, Materialien, Licht, Bewegung.
  2. Route. Wähle das Rendering-Modell und die Startvorlage aus references/subject-routing.md: 2D Distanzfelder (Poster, Icons, Muster), SDF Raymarching (Objekte, Charaktere), Höhenfeld-Marching (Landschaften), Volumen-Integration (Wolken, Rauch, Feuer).
  3. Aus der Bibliothek zusammenstellen. Finde Bausteine mit python3 scripts/glsl_tools.py search <wörter> oder references/library-index.md und rufe sie beim Namen auf. Keinen Bibliothekscode kopieren oder neu ableiten; er ist getestet.
  4. Erstes Bild schnell. Koordinaten, Hintergrund, ein Primitiv, ein Licht. Danach die Debug-Ansichten hinzufügen.
  5. In der richtigen Reihenfolge verfeinern: Proportionen, Komposition, Materialtrennung, Beleuchtung, Atmosphäre, Farbe, Antialiasing, Leistung.
  6. Bündeln und prüfen. python3 scripts/glsl_tools.py bundle shader.glsl -o out.glsl fügt genau die verwendeten Funktionen ein. python3 scripts/glsl_tools.py check out.glsl lintet den Shader und kompiliert ihn mit glslangValidator (falls installiert). Jeden Fehler beheben, dann out.glsl ausliefern.

Führe die Skripte aus dem Verzeichnis dieses Skills aus. Sie benötigen nur Python 3.

Konventionen

  • Koordinaten: vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;, also ist ein Pixel 2.0 / iResolution.y.
  • Szene-Vertrag: vec2 map(vec3 p) gibt vec2(distanz, materialId) zurück. raymarch, calcNormal, softShadow, calcAO und sdfThickness verwenden es alle.
  • Debug: #define DEBUG_MODE 0 mit 0=final, 1=Distanzfeld, 2=Normalen, 3=IDs, 4=Schritte, 5=Masks, 6=Beleuchtungsterme.
  • Farb-Pipeline: Licht in linear und ausgewählte Farben mit srgbToLinear dekodieren. Dann Belichtung, dann das Tonemapping (tonemapAgX standardmäßig pro AA-Sample), dann der Durchschnitt, dann linearToSrgb einmal, dann ditherTPDF.
  • Distanzen: Beachte die Tags @exact / @bound / @approx. Falls eine Verformung Lipschitz über 1 treibt, teile die Distanz oder senke den stepScale von raymarch.

Harte Regeln (sonst brechen Shadertoy/WebGL)

  • Keine #version-Zeile, keine benutzerdefinierten Uniforms, kein gl_FragColor / texture2D / iGlobalTime.
  • Kein ?: auf Structs. Verwende vec2(distanz, id) oder if.
  • Float-Literale schreiben: 2.0 * PI, clamp(x, 0.0, 1.0).
  • Keine fract(sin(...) * 43758.5453)-Hashes. Verwende hash12 / hash22 / hash33 (integer PCG). Ersetze sie auch beim Portieren mit "keep the look": Das exakte Muster des Sinus-Hashs variiert bereits zwischen GPUs, und ein PCG-Hash auf denselben Integer-Zellen-IDs verleiht dem Rauschen das gleiche Aussehen. check meldet einen Sinus-Hash als Fehler.
  • NaN-Quellen absichern: atan(0, 0), pow von Negativen, sqrt von Negativen, normalize(vec3(0)).
  • dFdx / fwidth aus nicht-uniformen Verzweigungen und Schleifen heraushalten, oder eine explizite Pixelgröße verwenden.

Referenz-Routing

Lies nur, was die Aufgabe benötigt:

DateiLesen, wenn ...
references/subject-routing.mdvon einem Motiv ausgehend ("eine Qualle", "Berge"); bildet formale Namen auf Motive ab
references/library-index.mdFunktionen auswählen: jede Bibliotheksfunktion mit Signatur, Genauigkeit und Verwendung
references/sdf-library-guide.mdModellierung: Genauigkeitsstufen, Blends, nachbar-geprüfte Wiederholungen, Verformungsgrenzen, WebGL-Fallstricke
references/rendering-pipeline.mdBeleuchtungs-Setups, Schatten/AO, Himmel und Nebel, Volumen, Tonemapping, AA, Leistung
references/noise-use-cases.mdPerlin/Value/Simplex/Cellular-Rauschen auswählen, fBm/ridged/billow/warp/hybrid-Rezepte, Anwendungsfälle und Quellcode-Links
references/procedural-buildings.mdParzellen-IDs, Gebäude-Massing, Rücksprünge/Dächer, Fassadenfilterung, Stadt-Wiederholungen und Spielintegration
references/terrain-production.mdGeländedarstellungen, entworfene Täler, Hang-/Höhenmaterialien, Tracing-Grenzen, Chunks und LOD
references/water-quality.mdhochwertiges Ozean-/Küstenwasser, Wellenableitungen, Fresnel/Brechung/Absorption, Schaum, Voreinstellungen und Engine-seitige Upgrades
references/shader-workflow.mdPlanung eines komplexen Shaders von Anfang bis Ende; Checkliste zur Überprüfung
references/composition-and-debugging.mddas Bild liest sich schlecht, oder etwas ist visuell falsch
references/formula-cookbook.mdmehrstufige Rezepte: modulare Zellgitter, Geländesynthese, organische Komposition
references/formula-code-couples-sdf.mdGleichung-zu-Code für organische und modulare SDF-Merkmale
references/formula-code-couples-terrain.mdHöhenfelder, Dichtefelder, Akkumulation, Atmosphäre
references/formula-code-couples-materials.mdMasken, Paletten, Beleuchtungsterme, Politur, Bewegung

Vorlagen in templates/ sind vollständige, rendergeprüfte Startpunkte (Galerie in der Repository-README): raymarch-sdf.glsl, terrain.glsl, ocean.glsl, volumetric-clouds.glsl, sdf-2d-poster.glsl, pattern-swatches.glsl, noise-progression.glsl, noise-terrain-map.glsl, procedural-city.glsl, alpine-valley.glsl, coastal-water.glsl.

Ausgabeerwartungen

Beim Schreiben eines Shaders:

  • Liefere den gebündelten, paste-bereiten Shadertoy-Code mit mainImage(out vec4 fragColor, in vec2 fragCoord).
  • Vermeide Texturen, es sei denn der Benutzer stellt sie bereit.
  • Füge DEBUG_MODE-Schalter ein und benenne die Kunststeuerungen als Konstanten oben.
  • Beende mit einer kurzen Abstimmungsanleitung: welche Konstanten Skalierung, Weichheit, Farbe, Licht und Bewegung steuern.
  • Gib an, ob der Shader compilierungsgeprüft wurde und wie.
  • Bei Gebäuden/Gelände/Wasser getrennt implementierte Funktionen von Engine-seitigen Upgrades aufführen. Nenne ein Höhenfeld nicht Höhlengenerator, ein Materialfenster nicht modellierte Vertiefung oder eine prozedurale Schaum-/Kaustik-Maske nicht Flüssigkeits-/Lichtsimulation.
  • Bei Qualitätsanfragen: Ziel und Budget angeben, Voreinstellungen/Debug-Ansichten bereitstellen und gerenderte Ausgabe inspizieren. Wichtige Vorlagen-Voreinstellungen mit // @variant QUALITY=3 (oder einem anderen definierten Integer-Makro) annotieren, damit CI sie kompiliert und rendert. Horizont-/Küsten-Kontakt und zeitliche Filterung erhalten, bevor Details hinzugefügt werden.

Bei der Verbesserung eines bestehenden Shaders:

  • Identifiziere sein Rendering-Modell und seine Engpässe.
  • Bewahre seine Absicht und Schnittstelle.
  • Behebe zuerst Korrektheitsfehler, dann Lesbarkeit, visuelle Qualität und Geschwindigkeit.
  • Weise auf riskante Änderungen hin (Koordinatenskalierung, Material-IDs, Schleifenzahlen).

Verwandte Skills