threejs-shaders

Three.js shaders - GLSL, ShaderMaterial, uniforms, custom effects. Use when creating custom visual effects, modifying vertices, writing fragment shaders, or extending built-in materials.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/threejs-shaders/SKILL.md

The canonical home for this skill is threejs-shaders in CloudAI-X/threejs-skills

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, code-rich shader reference with excellent copy-paste examples, weakened by an inlined GLSL/material-property reference that pads the token budget and no progressive disclosure into bundle files. Splitting the reference sections into separate files and trimming standard GLSL function lists would materially improve it.

Suggestions

Move the "GLSL Built-in Functions" and "Common Material Properties" reference tables into a separate REFERENCES.md file (or trim them), since Claude already knows standard GLSL functions and ShaderMaterial properties.

Add a short, sequenced debugging workflow (compile-check -> visual debug -> inspect WebGL errors) with an explicit feedback loop instead of three detached snippets in the Debugging Shaders section.

Split the Common Shader Patterns catalog into a PATTERNS.md bundle referenced from the Quick Start overview so SKILL.md stays a lean entry point.

Dimension	Reasoning	Score
Conciseness	Mostly efficient code-centric content, but the "GLSL Built-in Functions" and "Common Material Properties" sections re-list standard GLSL functions and ShaderMaterial properties that Claude already knows, which is padding.	3 / 5
Actionability	Fully executable, copy-paste-ready ShaderMaterial examples cover the common cases (uniforms, varyings, texture sampling, vertex displacement, fresnel, noise, dissolve, onBeforeCompile, instancing, debugging).	5 / 5
Workflow Clarity	Well-organized topical sections with self-contained patterns and no destructive/batch operations requiring validation; the Debugging Shaders section is fragmented rather than a sequenced workflow, which is a minor gap.	4 / 5
Progressive Disclosure	Good section headers structure a single ~640-line file, but everything is inlined with no bundle references, and content that could be split (GLSL function reference, pattern library) is not separated out.	3 / 5
	Total	15 / 20 Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that clearly states both capability and trigger conditions with concrete actions. Minor improvements could add a few more natural synonyms and sharpen the boundary against sibling Three.js skills.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ("creating custom visual effects, modifying vertices, writing fragment shaders, or extending built-in materials") with minor gaps in coverage such as post-processing or compute shaders.	4 / 5
Completeness	Explicitly answers both what ("Three.js shaders - GLSL, ShaderMaterial, uniforms, custom effects") and when ("Use when creating custom visual effects, modifying vertices, writing fragment shaders, or extending built-in materials") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural phrases users would say ("custom visual effects", "writing fragment shaders", "extending built-in materials") alongside technical terms; a few natural synonyms like "vertex shaders" or "shader code" are missing.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (Three.js shaders) with specific triggers, but the See Also references to sibling threejs-materials and threejs-postprocessing skills indicate minor overlap risk with closely related skills.	4 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (643 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: calesthio/OpenMontage
Path: .agents/skills/threejs-shaders/SKILL.md
Commit: 1bab711

Reviewed: about 21 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.