threejs-materials

Three.js materials - PBR, basic, phong, shader materials, material properties. Use when styling meshes, working with textures, creating custom shaders, or optimizing material performance.

Quality

85%

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

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

Quality

Content

77%

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

A highly actionable, well-organized Three.js materials reference with executable code throughout, but it is a long monolithic single file that re-lists many standard properties and does not split detailed reference material into bundle files.

Suggestions

Move the exhaustive per-material property listings (especially MeshPhysicalMaterial) into a references/ file such as MATERIAL_PROPERTIES.md, keeping SKILL.md as a concise overview + Quick Start that links out for full property detail.

Trim standard base properties (color, transparent, opacity, map) that Claude already knows; retain only non-obvious properties and gotchas (e.g. aoMap requires uv2, linewidth >1 only on some systems, needsUpdate triggers) inline.

Add a short end-to-end example workflow (load texture → set maps → set uv2 for aoMap → assign to mesh) so the typical multi-step task sequence is explicit rather than implied across scattered sections.

Dimension	Reasoning	Score
Conciseness	Prose is lean with almost no concept explanation, but the ~515-line body exhaustively lists many standard base properties (color, transparent, opacity, map) Claude already knows, so it is mostly efficient yet could be tightened — score 2 rather than the lean 'every token earns its place' of 3.	2 / 3
Actionability	Every section ships complete, executable, copy-paste-ready material definitions with commented property values and a working Quick Start, matching the score-3 anchor for fully executable examples.	3 / 3
Workflow Clarity	For this reference skill the single action (instantiate a material and assign it to a mesh) is shown unambiguously in Quick Start, sections are well organized, and there are no destructive/batch operations that would require validation checkpoints, so the simple-skill leniency applies and it earns 3.	3 / 3
Progressive Disclosure	No bundle files exist and the entire API reference — including the very long MeshPhysicalMaterial property listing — is inline in SKILL.md, so content that should be split into a reference file is inline; well-organized but not appropriately split, matching the score-2 anchor.	2 / 3
	Total	10 / 12 Passed

Description

92%

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 description: concrete, third-person, with an explicit 'Use when' clause covering both what and when. The only weakness is trigger overlap with sibling texture/shader skills, which slightly raises conflict risk.

Suggestions

Narrow the 'Use when' triggers to material-centric tasks and drop or de-emphasize 'working with textures' and 'creating custom shaders', which collide with the threejs-textures and threejs-shaders skills; defer those to the See Also list.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "styling meshes, working with textures, creating custom shaders, or optimizing material performance" — rather than vague language, matching the score-3 anchor.	3 / 3
Completeness	Explicitly states both what ("Three.js materials - PBR, basic, phong, shader materials, material properties") and when ("Use when styling meshes..."), satisfying the score-3 anchor for an explicit 'Use when' trigger.	3 / 3
Trigger Term Quality	Natural user-facing terms ("styling meshes", "working with textures", "creating custom shaders", "optimizing material performance") are well covered alongside the domain keywords, matching good coverage of terms users would say.	3 / 3
Distinctiveness Conflict Risk	The skill is material-specific, but "working with textures" and "creating custom shaders" overlap with the sibling threejs-textures and threejs-shaders skills cited in See Also, so it could trigger for the wrong skill; not the clear, conflict-free niche of score 3.	2 / 3
	Total	11 / 12 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 (521 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: calesthio/OpenMontage
Path: .agents/skills/threejs-materials/SKILL.md
Commit: 0af32ce

Reviewed: 1 day 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.