unity-material
Edit material and shader properties across Built-in/URP/HDRP
Install / Use
npx skills add Besty0728/Unity-Skills --skill materialInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of unity-material
unity-material scores 91/100 on our quality scale, 1078th of 4,698 Development & Engineering skills we index (top 23%).
Its SKILL.md is 20 KB long, well organised into 34 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.
With 1,781 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so unity-material is actively maintained.
- Our last check on 2026-10-29 found the source still online.
- 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. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
unity-material compared with similar skills
All 4 of these similar skills score higher than unity-material; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| unity-material (this skill)by Besty0728 | 91 | 1.8k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install unity-material?
- Run
npx skills add Besty0728/Unity-Skills --skill unity-material. The install tabs above show the steps for each supported agent. - Which AI agents does unity-material work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is unity-material safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. 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 unity-material still maintained?
- The repository was last updated about 2 months ago, so unity-material is actively maintained.
Skill content
View source on GitHubname: unity-material description: Edit material and shader properties across Built-in/URP/HDRP
Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via
GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Changing how a surface looks
- Tweaking material parameters
- Swapping shaders
- 调整物体外观、修改材质参数、切换 Shader
Unity Material Skills
BATCH-FIRST: Use
*_batchskills when operating on 2+ objects/materials.
Operating Mode
- Approval (default): all mutating skills (
material_create,material_create_batch,material_assign,material_assign_batch,material_duplicate,material_set_color/_emission/_texture/_float/_int/_vector/_keyword/_render_queue/_shader/_texture_offset/_texture_scale/_gi_flags, and the*_batchvariants) need user grant; grant triggers a single server-side execution that returns the result. - Auto / Bypass: those skills execute directly.
- Query skills (
material_get_properties,material_get_keywords) areSkillMode.SemiAuto— they run in all three modes without grant. - This module contains no Delete / PlayMode / Reload / high-risk skills (no NeverInSemi); to delete a material asset, call the
assetmodule.
Guardrails
DO NOT (common hallucinations):
material_set_metallic/material_set_smoothnessdo not exist → usematerial_set_floatwithpropertyName="_Metallic"or"_Glossiness"(Standard) /"_Smoothness"(URP)material_set_colorr/g/b/a range is 0–1, not 0–255material_set_propertydoes not exist → use the specific setter:material_set_float,material_set_int,material_set_vector,material_set_colormaterial_get_colordoes not exist → usematerial_get_properties(returns all properties including colors)
Routing:
- For shader changes →
material_set_shader(this module) - For texture tiling →
material_set_texture_scale/material_set_texture_offset - Pipeline-specific property names differ: check Render Pipeline Compatibility table in this doc
⚠️ Targeting a GameObject edits the material asset, not that one object. There is no per-object material instance here: every
material_set_*resolves a GameObject torenderer.sharedMaterialand writes the asset on disk — an asset mutation, not a scene edit, whatever the individual skill's declared flags say. A freshly created primitive carries Unity's built-inDefault-Material, somaterial_set_color(name="Cube")recolours every object in the project still using it — the classic "I coloured one cube and the whole scene changed" bug. Target by GameObject name only after confirming that object owns a material nobody else shares (material_get_properties→materialPathnames the asset that would be written).
Safe route for "make this object red" — create, colour the asset by path, then assign:
unity_skills.call_skill("material_create", name="Red", savePath="Assets/Materials")
unity_skills.call_skill("material_set_color", path="Assets/Materials/Red.mat", r=1, g=0, b=0)
unity_skills.call_skill("material_assign", name="Cube", materialPath="Assets/Materials/Red.mat")
Object Targeting: Most single-object skills accept
name(GameObject name) orpath. Behaviour ofpath:
- In
material_set_*/material_get_*(color/emission/texture/float/int/vector/keyword/shader/render_queue/gi_flags/properties),pathmay be either a GameObject hierarchy path or a material asset path likeAssets/Materials/X.mat— the skill auto-detects (paths starting withAssets/or ending with.matare treated as material assets).- In
material_assign,pathis a GameObject hierarchy path only; the material to assign goes in the separatematerialPathparameter.
Skills Overview
| Single Object | Batch Version | Use Batch When |
|---------------|---------------|----------------|
| material_create | material_create_batch | Creating 2+ materials |
| material_assign | material_assign_batch | Assigning to 2+ objects |
| material_set_color | material_set_colors_batch | Setting colors on 2+ objects |
| material_set_emission | material_set_emission_batch | Setting emission on 2+ objects |
No batch needed:
material_set_texture- Set texturematerial_set_texture_offset/material_set_texture_scale- Texture tilingmaterial_set_float/material_set_int/material_set_vector- Set propertiesmaterial_set_keyword- Enable/disable shader keywordsmaterial_set_render_queue- Set render queuematerial_set_shader- Change shadermaterial_set_gi_flags- Set global illumination flagsmaterial_get_properties/material_get_keywords- Query propertiesmaterial_duplicate- Duplicate material
Skills
material_create
Create a new material (auto-detects render pipeline).
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | Yes | - | Material name |
| shaderName | string | No | auto-detect | Shader (auto-detects URP/HDRP/Standard) |
| savePath | string | No | null | Save path (folder or full path) |
material_create_batch
Create multiple materials.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| items | json string | Yes | - | JSON array of per-item objects (see example below) |
Returns: {success, totalItems, successCount, failCount, results: [{success, name, path}]}
unity_skills.call_skill("material_create_batch", items=[
{"name": "Red", "savePath": "Assets/Materials"},
{"name": "Blue", "savePath": "Assets/Materials"},
{"name": "Green", "savePath": "Assets/Materials"}
])
material_assign
Assign material to object's renderer.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | Instance ID |
| path | string | No* | GameObject hierarchy path |
| materialPath | string | Yes | Material asset to assign (e.g. Assets/Materials/X.mat) |
material_assign_batch
Assign materials to multiple objects.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| items | json string | Yes | - | JSON array of per-item objects (see example below) |
Returns: {success, totalItems, successCount, failCount, results: [{success, gameObject, material}]} — each item echoes gameObject (the object name) and material (the assigned asset path); failures come back as {error, target}.
unity_skills.call_skill("material_assign_batch", items=[
{"name": "Cube1", "materialPath": "Assets/Materials/Red.mat"},
{"name": "Cube2", "materialPath": "Assets/Materials/Blue.mat"}
])
material_set_color
Set material color with optional HDR intensity.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | No* | - | GameObject name |
| instanceId | int | No* | 0 | GameObject instance ID |
| path | string | No* | - | Material asset path |
| r, g, b | float | No | 1 | Color (0-1) |
| a | float | No | 1 | Alpha |
| propertyName | string | No | auto-detect | Color property |
| intensity | float | No | 1.0 | HDR intensity (>1 for bloom) |
Returns: {success, target, color, intensity, propertyUsed, hdrEnabled}. Auto-detection tries the pipeline's property first, then _BaseColor, _Color, _TintColor, _EmissionColor, and propertyUsed reports which one it actually wrote — check it before concluding a colour "didn't apply".
material_set_colors_batch
Set colors on multiple objects. Each item accepts: identifier (name/instanceId/path) + r, g, b, a, optional per-item propertyName.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| items | json string | Yes | - | JSON array of {name\|instanceId\|path, r, g, b, a} per-item objects (see example below) |
| propertyName | string | No | auto-detect | Default color property applied to all items unless overridden |
Returns: {success, totalItems, successCount, failCount, results: [{target, success}]} — the per-item key is target (GameObject name, or the path when you addressed the asset), not name; failures come back as {error, target}.
unity_skills.call_skill("material_set_colors_batch", items=[
{"name": "Cube1", "r": 1, "g": 0, "b": 0},
{"name": "Cube2", "r": 0, "g": 1, "b": 0},
{"name": "Cube3", "r": 0, "g": 0, "b": 1}
])
material_set_emission
Set emission color with auto-enable keyword.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | No* | - | GameObject name |
| instanceId | int | No* | 0 | GameObject instance ID |
| path | string | No* | - | Material asset path |
| r, g, b | float | No | 1 | Emission color (0-1) |
| intensity | float | No | 1.0 | HDR intensity (>1 for bloom) |
| enableEmission | bool | No | true | Auto-enable _EMISSION keyword |
material_set_emission_batch
Set emission on multiple objects.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| items | json string | Yes | - | JSON array of per-item objects (see example below) |
Returns: {success, totalItems, successCount, failCount, results: [{success, name}]}
unity_skills.call_skill("material_set_emission_batch", items=[
{"name": "Neon1", "r": 1, "g": 0, "b": 1, "intensity": 5.0},
{"name": "Neon2", "r": 0, "g": 1, "b": 1, "intensity": 5.0}
])
material_set_texture
Set material texture.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | No* | - | GameObject name |
| instanceId | int | No* | 0 | GameObject instance ID |
| path | string | No* | - | Material asset path |
| texturePath | string | Yes | - | Texture asset path |
| propertyName | string | No | auto-detect | Texture property |
material_set_float
Set a float property on a material.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | GameObject instance ID |
| path | string | No* | Material asset path |
| propertyName | string | Yes | Property name |
| value | float | Yes | Value |
material_set_int
Set an integer property on a material.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameObject name |
| instanceId | int | No* | GameObject instance ID |
| path | string | No* | Material asset path |
| propertyName | string | Yes | Property name |
| value | int | Yes | Value |
material_set_keyword
Enable/disable shader keywords.
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| name | string | No* | - | GameObject name |
| instanceId | int | No* | 0 | GameObject instance ID |
| path | string | No* | - | Material asset path |
| keyword | string | Yes | - | Keyword name |
| enable | bool | No | true | Enable or disable |
Common Keywords: _EMISSION, _NORMALMAP, _METALLICGLOSSMAP, _ALPHATEST_ON, _ALPHABLEND_ON
material_get_properties
Get all material properties.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| name | string | No* | GameO
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
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.
