Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add arjun988/blender-skills --skill materials -a claude-code
Open on GitHub

What 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_Base master 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-code

2Manually: put the files in place

~/.claude/skills/materials/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/materials/

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

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set57

The whole set →
rigging Skill for automated production rigging in Blender via MCP. Used before animation tasks to handle armatures, constraints, and weight painting. CX Codex +1 747installs blender-modeler blender-modeler — a skill for Claude Code and other platforms handling 3D modeling in Blender via MCP. It manages geometry, modifier stacks, and scene organization. CX Codex +1 745installs character-artist The character-artist skill for Claude Code builds AAA character models with animation-ready topology in Blender via MCP. CX Codex +1 738installs asset-optimization The asset-optimization Claude Code skill checks and optimizes Blender 3D assets before export using MCP scene queries. Runs geometry audits, cleans topology, generates LOD meshes, and writes validation reports. CX Codex +1 720installs environment-artist The environment-artist Claude Code skill guides game environment work in Blender, from modular buildings and terrain to vegetation and scene composition. It applies to architecture, interiors, exteriors, and level art. CX Codex +1 697installs animation This skill automates game-ready animation workflows in Blender. It activates when defining keyframes for characters or mechanical objects. CX Codex +1 675installs uv-workflow uv-workflow — a skill that automates UV unwrapping in Blender via MCP. Runs when preparing meshes for texturing and game engine export. CX Codex +1 672installs qa-review qa-review — a skill for Claude Code reviews Blender assets with viewport screenshots, checklists, and naming audits. It runs before export or handoff and after major modeling or lookdev milestones. CX Codex +1 672installs

Project sponsors

Companies that keep this analytics open