scenario-godot-shaders
Use when writing or fixing Godot 4.7 shaders: .gdshader code (spatial, canvas_item, particles, sky, fog), VisualShader graphs built in code, stylized or toon water, dissolve or burn effects, hit flash, outlines, X-ray or portals with the stencil buffer, depth or screen-texture post-processing, globa…
Install / Use
npx skills add scenario-labs/skills --skill scenario-godot-shadersInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
DesignSupported Platforms
Tags
Our assessment of scenario-godot-shaders
scenario-godot-shaders scores 86/100 on our quality scale, 159th of 269 Design skills we index.
Its SKILL.md is 20 KB long, well organised into 11 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 35 days ago, so scenario-godot-shaders is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-godot-shaders compared with similar skills
All 4 of these similar skills score higher than scenario-godot-shaders; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-godot-shaders (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
| ad-creativeby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install scenario-godot-shaders?
- Run
npx skills add scenario-labs/skills --skill scenario-godot-shaders. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-godot-shaders work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-godot-shaders safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-godot-shaders still maintained?
- The repository was last updated 35 days ago, so scenario-godot-shaders is actively maintained.
Skill content
View source on GitHubname: scenario-godot-shaders description: "Use when writing or fixing Godot 4.7 shaders: .gdshader code (spatial, canvas_item, particles, sky, fog), VisualShader graphs built in code, stylized or toon water, dissolve or burn effects, hit flash, outlines, X-ray or portals with the stencil buffer, depth or screen-texture post-processing, global or per-instance uniforms, compute shaders and Texture2DRD, the shader baker; or when 'shader compiles but looks wrong', 'black screen from my post effect', 'my Godot 3 shader breaks', 'colors look washed out', 'first-launch shader stutter'." license: MIT
Godot shaders (technical artist, shading)
Target: Godot 4.7.2.stable, macOS Apple Silicon (Metal by default, Vulkan through MoltenVK for GPU timing).
Expert level here means every shader is text the agent can diff, compiled under each target
renderer, drawn on a real mesh in a window, swept across its parameters and looked at on a contact
sheet, with its GPU cost measured against a StandardMaterial3D baseline. Compiling is not the same
as working: several 4.7.2 failures only appear when the backend draws, and several bugs produce no
error at all. If a sibling skill named here is missing from your available skills, load it with
skill_get (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.
REQUIRED BACKGROUND: scenario-godot-expert (channels, gd_run, the review loop, 4.7 traps).
Stance (the expert delta)
- Code first, graphs on request. Text shaders give loops, functions,
#includeand clean diffs (Godotneers, Shaderland [01:10:09]; Daniel Ilett on the gaps of VisualShader). When a human wants a graph, build the VisualShader in code (add_node,connect_nodes, an Expression node for the maths) and save it as.tres; port names are not exposed to GDScript, so output indices are hard-coded and checked by readingget_code()[added, run 2026-10-02]. - Compile headless, then draw windowed. Headless
get_shader_uniform_list()catches language errors per--rendering-methodin about 0.4 s per renderer. Stencil reads in the opaque pass and fog shaders under Compatibility only fail when a window draws them. Uninitialized locals andDEPTHwritten in one branch never fail at all, so the linter checks those [added, run 2026-10-02]. - World or object space beats mesh UVs. Dissolve, wind, water and triplanar effects should be
driven from object-space or world-space coordinates, so seams and UV stretch disappear
(StayAtHomeDev dissolve [00:09:59], DevPoodle triplanar, Dylearn grass). For a shared material,
put the per-object values (bounds, amount) in
instance uniforms, or each mesh dissolves at the wrong height [added]. - Water that does not slide. Use two panned copies of one seamless cellular noise, multiply
them, raise to 1.25, and share them between
vertex()andfragment()so the crests sit on the wave tops (Bramwell [00:11:57 to 00:20:57]). Use hybrid toon bands, a smoothstep only near each cut, so the bands do not flicker (Dylearn [00:13:42]). Shore foam comes from vertical depth, reconstructed from the depth texture with the reversed-z formula [added]. - HDR edges need three things together: a color above 1.0, the EMISSION output, and Glow in the WorldEnvironment (StayAtHomeDev [00:07:36], Daniel Ilett [00:10:22], Pixezy [00:06:55]).
- Know what moves a material to the transparent pass. Writing
ALPHAor reading the screen or depth texture moves it there. It loses shadows and sorting, and it is invisible to other screen-reading materials (docs). UseALPHA_SCISSOR_THRESHOLDfor dissolves: the material stays opaque and the shadow dissolves too. Scissor is still an alpha test: likediscard, it gives up early-Z for that mesh (docs), which costs most on mobile tile GPUs, so swap the dissolve material in only for the effect (P18). Stencil readers must be transparent, with arender_priorityabove the writer's (LowQualityCoding [00:07:35]). - Compute: on screen, stay on the main device. Texture2DRD needs the main RenderingDevice
inside
RenderingServer.call_on_render_thread, and no submit or sync (The Pathfinders Codex [00:03:07]). To get results back on the CPU, use a local device, free every RID and test parity against a CPU version (DevPoodle [00:02:21], Crigz [00:11:24]). - Bake shaders from a windowed export. The shader baker runs only when the export process has a
rendering device. A
--headlessexport withshader_baker/enabled=truesilently packs nothing extra [added, run 2026-10-02].
Establish first
- Target renderers: Forward+ (desktop), Mobile (phones), Compatibility (web, old GPUs); each decides which hints and stages exist. Default: Forward+ plus one named fallback.
- Style: toon, PBR or pixel art. Decide the band count, the outline method (stencil or inverted hull) and whether Glow is on.
- Budget: GPU ms per effect against a StandardMaterial3D baseline. Default: under +0.5 ms at 1080p on this Mac for a hero effect, confirmed on the device.
- Who edits: an agent (text) or a human artist too (VisualShader
.tres, grouped uniforms with hints). - Shared or unique materials: per-instance values decide between instance uniforms (at most 16, no textures), unique materials and globals.
Workflow
- Install and lint.
gd_shaders.install(project)copies the templates intores://shaders/and the tools intoaddons/agentkit/shaders/. Thengd_shaders.lint(path, renderers, project=P). GATE: noerrorfindings; everywarnfixed or justified. - Compile per renderer.
gd_shaders.compile_matrix(P, root="res://shaders/"). GATE:okwith an emptyfailedlist for every target renderer. - Draw once per renderer.
gd_shaders.draw_check(P, files)puts each shader on a drawn mesh, canvas item, sky, particle system or fog volume. GATE: zeroshader_errorsandengine_errorsin each run. - Build the test scene in code. Write a job that saves a
.tscnwith the camera, the light and the Environment set explicitly: AgX, Glow on or off as the brief says. Water needs ground crossing the water level and objects above and below it. A dissolve needs at least three meshes with different sizes and rotations. GATE: the scene loads headless withok, and the project.godot renderer and Jolt settings were checked. - Sweep and look. Run
gd_shaders.param_sweep(P, scene, shots=...)with kindsshader,instance,globalorprop. Open the contact sheet. GATE:changesbehave as expected (a monotonic dissolve, a moving phase), and the sheet shows the intended look in every shot. - Compare renderers.
gd_shaders.renderer_captures(P, scene). GATE: the look holds under each target renderer; known differences are written down (Compatibility renders brighter and more saturated with the same Environment). - Cost.
gd_shaders.cost_compare(P, {"standard": ..., "hq": ..., "lite": ...})on Vulkan at 1080p. GATE: the delta against the baseline is within budget; mobile numbers are marked "desktop proxy". - Ship. Add a macOS or target preset with
shader_baker/enabled=true. Export once from a windowed process (see procedures.md P14). GATE: the log shows "Baking shaders (N steps)" and the pack grows. A missing global uniform shows up here as an error.
Side paths:
- VisualShader for a human artist (P9): build the graph in code with an Expression node and save
it as
.tres. Read it back withshader_tools.gd:visual_shader, which returns the generated code, the node counts and the uniforms. Then sweep it like a text shader. GATE: the generated code contains every expected output assignment. - Compute (P12, P13): run
compute_probewindowed for the CPU parity check. Use the Texture2DRD job for on-screen output. GATE: zero mismatches, no leaked RIDs, and frames that change. - Globals (P11): register the global with
register_global(it writes the editor's multi-line format). Set live values withRenderingServer.global_shader_parameter_setand keep a copy in an autoload: the getter stalls the render thread (docs).ProjectSettings.set_settingat runtime does not register a global. - Animating parameters: a Tween or an AnimationPlayer track on
instance_shader_parameters/dissolve_amountdrives an instance uniform;shader_parameter/<name>drives a material uniform (P8).
Expert checklist (state these in the plan)
- Complete code in the deliverable. Paste the full templates
(
dissolve.gdshader,water_stylized.gdshaderplus its include) and setup script: readers may lack the kit. source_coloron every color uniform and color sampler, never on normal, roughness or mask data (lintrulesource_color).- Uniform budget 16,384 B on mobile, vec3 padded to 16 B; big arrays go in a texture (
lintruleuniform_budget). TIMEwraps at 3,600 s and keeps running while paused (docs): drive pausable motion fromglobal uniform float game_time, written by thegame_time.gdautoload (P18).- Dissolve bounds. World space breaks when the mesh moves or scales; StayAtHomeDev feeds AABB
min and max from an
@toolscript (pIwQ 09:59 to 12:52). The template uses object space plus aninstance uniform vec2 boundsper mesh, which survives movement, scale and sharing. - Swap in for the effect.
dissolve_swap.gd:swap_in(mi, mat)puts one duplicate per surface (keeping each surface's albedo color and texture) and returns the originals forrestore(P18). - Sorting.
depth_prepass_alphawithcull_disabledfixes transparent sorting artifacts and keeps shadows (pIwQ 00:01:00). LIGHT_VERTEX(4.3) moves the lit position, for example snapped to a grid for stepped pixel-art light, without touchingVERTEX(Dylearn 00:01:25); it draws on all three renderers (P18).- Outlines. BaseMaterial3D
stencil_modeoutline on dense meshes; an inverted-hull next pass elsewhere (Daniel Ilett 15:18).
Numbers
| Value | Number | Relative to | | ----------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------ | | Headless compile, 3 renderers, 11 shaders | 1.3 s | M5 Max, run 2026-10-02 | | First windowed draw (pipeline build) | Metal 7.5 s, Mobile 5.3 s, Compat 1.6 s | cold cache, same probe set | | Water GPU p50 at 1080p | standard 2.9 to 3.2 ms, HQ 3.4 to 3.5, LITE 3.0 to 3.1 | Vulkan, 3 runs, whole frame | | HQ water (refraction) over baseline | +0.35 to 0.5 ms | same scene, StandardMaterial3D water | | Uniform buffer | 65,536 B desktop, 16,384 B mobile; vec3 pads to 16 B | official docs | | Instance uniforms per shader | 16, no samplers or arrays | docs, sampler rejected by the compiler | | Water noise | product of 2 pans, pow 1.25 | Bramwell
Truncated for display — read the full file on GitHub.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
ad-creative
60.1kWhen the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and variations for Google, Meta, LinkedIn, and TikTok, fresh angles when creative fatigues. Test hypotheses name the metric, comparison, and expected direction.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
