Agent skill · Audited from source
godot-shaders
skill · gamedev-skills/awesome-gamedev-agent-skillsApache-2.0 licenceAudited 14 Nov 2026 · source c974b5ce8f0d
Is it safe? Yes — SAFE, grade B (89/100). We read this skill's source at commit c974b5ce8f0d and found no filesystem, network or shell access and no hard-coded secrets. What it does: Godot 4.7 Shading Language syntax and pipeline: canvas_item, spatial and particle shaders, built-ins, ShaderMaterial wiring, a headless compile check and 3.x porting. Use for a .gdshader, a SHADER ERROR, shader…
Cite
Cite this page
ModelsAtlas. “godot-shaders (gamedev-skills/awesome-gamedev-agent-skills)”. Retrieved 14 Nov 2026. https://modelsatlas.com/skills/gamedev-skills/godot-shaders
Trust audit
Audit 0.4.1 · source read 14 Nov 2026
SAFE means nothing in the source contradicts what the skill says it does. Grade B is shared by 17,406 of 18,389 audited skills.
What the source does
- FilesystemNone observedNo reads or writes in the source
- NetworkNone observedNo outbound calls in the source
- ShellNone observedNo commands run in the source
- DependenciesPinnedNothing floats
- SecretsNone foundNo keys in source
Five audit layers
| Layer | What we check | Result | Findings |
|---|---|---|---|
L0 Provenance | Repo owner, licence, archive status, activity | PASS | 0 |
L1 Static source | Secrets, path traversal, supply chain, hidden code | NA | 0 |
L2 Instructions | Prompt injection, authority framing, hidden directives | PASS | 0 |
L3 Inventory | The files and declarations match the source | PASS | 0 |
L4 Sandbox | Run in isolation and watch behaviour | SKIPPED why | 0 |
Gates applied: no behavioural pass.
Findings (0)
No findings at any severity. We re-audit when the source changes.
Audit 0.4.1 · source sha c974b5ce8f0d · 14 Nov 2026Report an issue or request a re-scan
Provenance
Who published it, and what the verdict is pinned to
- Publishergamedev-skills GitHub organizationOwner of the repository this skill is read from
- Source foldergamedev-skills/awesome-gamedev-agent-skills/skills/godot/godot-shadersThe exact folder we audited
- LicenceApache-2.0As the repository states it
- Commit pinned for this verdictc974b5ce8f0dA new audit runs when the source changes
- Repository statusNot archivedLast push 1 day ago
- Sandboxed runNot runSkills are read, not executed; layer L4 is skipped
What it tells the agent
Full source on GitHub ↗Its description: Godot 4.7 Shading Language syntax and pipeline: canvas_item, spatial and particle shaders, built-ins, ShaderMaterial wiring, a headless compile check and 3.x porting. Use for a .gdshader, a SHADER ERROR, shader…
---
name: godot-shaders
description: >
Godot 4.7 Shading Language syntax and pipeline: canvas_item, spatial and particle shaders,
built-ins, ShaderMaterial wiring, a headless compile check and 3.x porting. Use for a .gdshader,
a SHADER ERROR, shader parameters set from GDScript, or an effect that looks washed out or sorts
wrong. Not for effect maths such as dissolve or outline (`shader-programming`).
---
# Godot Shaders (4.x)
Write `.gdshader` files in the Godot Shading Language, wire them to materials, and prove
they compile. Targets **Godot 4.7** (see Version notes). The effect technique (the maths
of a dissolve, outline, toon ramp) lives in `shader-programming`; this skill covers
Godot's syntax, built-ins and pipeline.
## When to use
- Writing or porting `.gdshader` code, fixing a `SHADER ERROR`, wiring a
`ShaderMaterial`, picking render modes, or setting uniforms from code.
**When *not* to use:** cross-engine shading technique → `shader-programming`;
`StandardMaterial3D`, lights and environment → `godot-3d-essentials`. `GPUParticles`
node properties (as opposed to a `particles` shader) are outside this skill.
## Core workflow
1. **Pick the shader type** on the first line: `shader_type canvas_item;` for anything
`CanvasItem` (Sprite2D, TextureRect, Control) or `shader_type spatial;` for 3D meshes.
`particles`, `sky` and `fog` exist too.
2. **Write the output the type expects:** `COLOR` in `canvas_item`; `ALBEDO`, `EMISSION`,
`ROUGHNESS`, `METALLIC` in `spatial`. `vertex()` moves geometry; `light()` replaces
lighting.
3. **Expose tunables as `uniform`s** with hints (`source_color` for colors, `hint_range`
for sliders) so they show in the Inspector and are color-managed.
4. **Wire the material.** In a `.tscn` this is plain text, so no Inspector clicks are
needed:
```ini
[ext_resource type="Shader" path="res://fx/scroll.gdshader" id="1_fx"]
[sub_resource type="ShaderMaterial" id="ShaderMaterial_fx"]
shader = ExtResource("1_fx")
shader_parameter/scroll_speed = 0.5
[node name="Water" type="Sprite2D" parent="."]
material = SubResource("ShaderMaterial_fx")
```
From code: `material.set_shader_parameter("scroll_speed", 0.5)`.
5. **Check before you finish.**
- Compile every shader headless with Pattern 4, then grep the log:
```bash
godot --headless --path . --script res://tests/compile_shaders.gd > shaders.log 2>&1
grep -nE "SHADER ERROR|Shader compilation failed" shaders.log # no output = pass
```
Headless uses a dummy renderer that still runs Godot's shader compiler, so syntax,
unknown built-ins, wrong output variables and bad hints all show up. It does not run
the GPU driver, so ask the user to open the scene with the project's renderer
(Forward+, Mobile or Compatibility) and report how it looks and any errors in the
Output panel.
- If you wired a material in a `.tscn`, also run the `godot-nodes-scenes` skill's
`scripts/check_godot_project.py <project-dir>` to confirm the `ext_resource` path.
- With no Godot binary (`godot`, `godot4` or `$GODOT_BIN`), ask the user to run the
command above and paste `shaders.log`.
## Patterns
### 1. canvas_item: tint and scrolling UV
```glsl
shader_type canvas_item;
uniform vec4 tint : source_color = vec4(1.0);
uniform float scroll_speed : hint_range(0.0, 2.0) = 0.3;
void fragment() {
vec2 uv = UV + vec2(TIME * scroll_speed, 0.0);
COLOR = texture(TEXTURE, uv) * tint; // TEXTURE = the node's own texture
}
```
The node's texture must repeat for the scroll to wrap: set `texture_repeat` on the
CanvasItem, or sample your own `uniform sampler2D tex : repeat_enable;`.
### 2. spatial: emissive rim on an opaque material
```glsl
shader_type spatial;
uniform vec4 base_color : source_color = vec4(0.2, 0.5, 1.0, 1.0);
uniform vec3 rim_color : source_color = vec3(0.6, 0.8, 1.0);
uniform float rim_power : hint_range(0.5, 8.0) = 3.0;
void fragment() {
ALBEDO = base_color.rgb;
float rim = pow(1.0 - clamp(dot(NORMAL, VIEW), 0.0, 1.0), rim_power); // view space
EMISSION = rim_color * rim; // no ALPHA write: stays opaque
}
```
### 3. Screen-reading post effect (4.x hint, not SCREEN_TEXTURE)
```glsl
shader_type canvas_item;
uniform sampler2D screen_tex : hint_screen_texture, filter_linear_mipmap;
uniform float blur : hint_range(0.0, 4.0) = 1.0;
void fragment() {
vec2 px = SCREEN_PIXEL_SIZE * blur;
vec4 c = texture(screen_tex, SCREEN_UV);
c += texture(screen_tex, SCREEN_UV + vec2(px.x, 0.0));
c += texture(screen_tex, SCREEN_UV - vec2(px.x, 0.0));
COLOR = c / 3.0;
}
```
### 4. Headless compile check for every `.gdshader`
```gdscript
# res://tests/compile_shaders.gd
extends SceneTree
func _initialize() -> void:
var paths := _find("res://", "gdshader")
for path in paths:
print("compiling ", path) # a SHADER ERROR prints right after this
var shader := load(path) as Shader
shader.get_shader_uniform_list() # forces the compile; load() alone is lazy
print("Compiled %d shaders" % paths.size())
quit(0)
func _find(dir: String, ext: String) -> PackedStringArray:
var found := PackedStringArray()
for file in DirAccess.get_files_at(dir):
if file.get_extension() == ext:
found.append(dir.path_join(file))
for sub in DirAccess.get_directories_at(dir):
if not sub.begins_with("."): # skips .godot/ and other hidden folders
found.append_array(_find(dir.path_join(sub), ext))
return found
```
Shaders embedded in a `.tscn` (`[sub_resource type="Shader"]`) are not files; cover them
by smoke-running that scene (`--scene res://... --quit-after 10`) and grepping the same way.
## Gotchas
- **3.x → 4.x renames.** `SCREEN_TEXTURE` and `DEPTH_TEXTURE` are removed; declare
`uniform sampler2D x : hint_screen_texture;` (or `hint_depth_texture`) and sample with
`SCExcerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.
Install
Pinned to the audited commit c974b5c
git clone https://github.com/gamedev-skills/awesome-gamedev-agent-skills git -C awesome-gamedev-agent-skills checkout c974b5ce8f0d
The author documents no install command, so this uses the repository directly. Our verdict covers commit c974b5ce8f0d only.
Works in
The author has not said which agents this skill supports, and we have not tested it in any.
Audit history
Every audit, every source change
- ✓SAFE B 89 / 100
first audit · source
c974b5ce8f0d
README badge
For maintainers · shows the latest audit
[](https://modelsatlas.com/skills/gamedev-skills/godot-shaders/)
The badge shows our verdict and grade for this skill, and links back to this page. It changes when the audit does.
Similar skills
gamedev-skills/awesome-gamedev-agent-skills
Godot 4.7 data-driven design with custom Resources: class_name and @export fields, .tres files, shared references vs duplicate_deep(), uids and threaded loading. Use for items, stats or enemy configs as data, or when…
gamedev-skills/awesome-gamedev-agent-skills
Godot 4.7 physics API in 2D and 3D: body and Area types, collision_layer and mask bits, Area signals for hurtboxes, RayCast and space queries, and Jolt (3D default since 4.6). Use when objects pass through each other,…
gamedev-skills/awesome-gamedev-agent-skills
Build networked games with Godot 4.7 high-level multiplayer: set up an ENetMultiplayerPeer server/client, define RPCs with the @rpc annotation (call via rpc()/rpc_id()), set per-node multiplayer authority, and replicate…
gamedev-skills/awesome-gamedev-agent-skills
Structure a Godot 4.7 project with the scene tree and node composition: build reusable scenes, instance PackedScenes at runtime, navigate the tree safely, and register autoload singletons. Use when designing .tscn…
gamedev-skills/awesome-gamedev-agent-skills
Export and build a Godot 4.7 project for distribution: install export templates, define export presets (Windows/macOS/Linux/Web/Android), run headless command-line exports for CI, and handle web (HTML5) COOP/COEP and…
gamedev-skills/awesome-gamedev-agent-skills
Write idiomatic GDScript for Godot 4.7: static typing, the node lifecycle (_ready/_process/_physics_process), @export/@onready/@tool annotations, signals, and await for asynchronous flow. Use when editing .gd scripts in…
Add this badge to your README
[](https://modelsatlas.com/skills/gamedev-skills/godot-shaders/)
<a href="https://modelsatlas.com/skills/gamedev-skills/godot-shaders/"><img src="https://modelsatlas.com/skills/gamedev-skills/godot-shaders/badge.svg" alt="ModelsAtlas: SAFE B"></a>
Questions about godot-shaders
What does the godot-shaders skill do?
Is godot-shaders safe to install?
What can godot-shaders access on my machine?
How current is this page?
Sources
- github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/main — the audited source at commit c974b5ce8f0d and every finding aboveObserved · 14 Nov 2026
Spotted something wrong? Report a correction · Methodology
Keep going in your AI
Opens with this page as the source. We add nothing else to the prompt.
- What does the godot-shaders skill do?
- Is godot-shaders safe to install?
- What can godot-shaders access on my machine?