materials — Claude Code skill: what it does, how to install
The materials skill automates PBR and stylized material creation in Blender via MCP. It is triggered during look development, procedural shader design, and production asset preparation.
MIT 708 installs ★ 4,589 updated 2026-11-06
npx skills add arjun988/blender-skills --skill materials -a claude-codeWhat materials does
The tool manages a master material library to ensure consistent look development and shader reuse. It handles PBR-compliant settings and procedural patterns, including wear, dirt, and rust masks, allowing agents to configure Principled BSDF parameters directly through MCP calls.
Operational success depends on an active Blender MCP server integration. Users should follow the MAT_[Surface]_[Descriptor] naming convention and stick to per-asset material budgets to maintain scene performance for engine exports.
What it helps with
- generate procedural materials with wear masks
- assign master materials to scene objects
- verify material counts within asset limits
- adjust BSDF parameters to PBR standards
Example prompts for the agent
- Apply the
MAT_Metal_Basemaster material to the selected objects. - Create a plastic instance with a Roughness of 0.5 via MCP.
- Check the scene for material budget compliance.
How to install materials
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill materials -a claude-code2Manually: put the files in place
~/.claude/skills/materials/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/materials/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill materials -a codex2Manually: put the files in place
.agents/skills/materials/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill materials -a cursor2Manually: put the files in place
.cursor/skills/materials/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install arjun988/blender-skills .claude/skills/materials2Manually: put the files in place
.github/skills/materials/SKILL.md1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill materials -a gemini-cli2Platform CLI
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/materialsManually: put the files in place
.devin/skills/materials/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill materials -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about materials
How to install materials in Claude Code?
Run npx skills add arjun988/blender-skills --skill materials -a claude-code in your project terminal.
What does materials do?
It streamlines material creation, assignment, and validation in Blender by using a reusable master library and standardized PBR workflows.
What is required for materials to work?
A functional Blender MCP server configured to connect with your coding agent.
Source text
SKILL.md · MIT
---
name: materials
description: Blender PBR and stylized material creation for metal, wood, concrete, fabric, glass, dirt, rust, and procedural shaders. Use for look development, material reuse, and production shading in Blender via MCP.
license: MIT
metadata:
author: https://github.com/arjun988
version: "1.0.0"
domain: blender
role: specialist
triggers: material, shader, PBR, procedural, metal, wood, fabric, glass, rust, moss, Principled BSDF
related-skills: texture-workflow, uv-workflow, lighting, rendering
---
# Materials
Production shading with material reuse. PBR-accurate or intentionally stylized. Minimal unique materials.
## When to Use
- Look development after UVs
- Procedural material creation
- Master material library setup
- Material variation from shared masters
- Engine export material preparation
## Workflow
```
Master Materials → Instance Variations → Object Assignment
→ Vertex Color/Mask Setup → Validation → Export Prep
```
## Master Material Library
Create reusable masters in `MAT_` prefix:
| Master | Base Setup |
|--------|------------|
| MAT_Metal_Base | Principled: Metallic 1, adjustable Roughness |
| MAT_Plastic_Base | Principled: Metallic 0, Specular 0.5 |
| MAT_Fabric_Base | Principled + Sheen |
| MAT_Glass_Base | Principled: Transmission 1, IOR 1.45 |
| MAT_Emissive_Base | Principled: Emission strength variable |
| MAT_Organic_Base | Subsurface scattering enabled |
Instance variations: duplicate master, adjust parameters only.
## PBR Value Ranges
| Material | Metallic | Roughness | Notes |
|----------|----------|-----------|-------|
| Polished metal | 1.0 | 0.1–0.3 | |
| Brushed metal | 1.0 | 0.4–0.6 | Anisotropic if available |
| Painted metal | 0.0 | 0.3–0.5 | Base color = paint |
| Plastic | 0.0 | 0.3–0.6 | |
| Rubber | 0.0 | 0.7–0.9 | |
| Concrete | 0.0 | 0.8–0.95 | |
| Wood (raw) | 0.0 | 0.5–0.7 | |
| Glass | 0.0 | 0.0 | Transmission 1 |
| Skin | 0.0 | 0.4–0.6 | Subsurface 0.1–0.3 |
| Fabric | 0.0 | 0.7–0.9 | Sheen |
## Procedural Material Patterns
**Wear mask:** Noise → ColorRamp → Lerp between clean/worn
**Edge wear:** Bevel node → Pointiness or Ambient Occlusion
**Dirt accumulation:** AO inverted → multiply with dirt color
**Rust:** Noise mask on metal → orange/brown color override
## Material Count Budget
| Asset Type | Max Materials |
|------------|---------------|
| Hero prop | 3–5 |
| Standard prop | 1–2 |
| Modular piece | 1 (atlas) |
| Character | 3–8 (body, cloth, eyes, hair) |
| Environment module | 1–2 |
## Vertex Color Usage
- RGB: variation masks (wear, moss, color variation)
- R: wear amount, G: dirt, B: wetness
- Document channel usage in material notes
## Stylized Materials
See stylized-style skill. Key differences:
- Flatten roughness range
- Hand-painted base color priority
- Rim light via Fresnel mix
- NPR toon shaders if project requires
## MCP Integration
1. Create material slots via MCP
2. Assign materials to objects via MCP
3. Set principled BSDF parameters via MCP
4. Query material count per scene
5. Verify material names follow convention
## Constraints
### MUST DO
- Reuse master materials; instance variations
- Name materials `MAT_[Surface]_[Descriptor]`
- Match PBR values to style skill direction
- Limit material count per asset budget
- Test materials in target lighting setup
### MUST NOT DO
- Unique material per object (unless hero)
- PBR values outside physically plausible range (realistic style)
- Skip vertex color masks for variation
- Leave default material names
- Finalize materials before UVs complete
## Reference Guide
| Topic | Reference | Load When |
|-------|-----------|-----------|
| Surface recipes | `references/surface-recipes.md` | Specific materials |
| Procedural nodes | `references/procedural-patterns.md` | Wear, dirt, variation |
© https://github.com/arjun988 · MIT · arjun988/blender-skills