Agent skill

Scenario Blender Expert

by scenario-labs in scenario-labs/skills

A skill your agent uses when doing any 3D work in Blender through Python or an MCP bridge, headless or in a live session: modeling, sculpting a character or head, retopology, UV unwrapping, baking…

MITAuto-check passedGame Development

Install Scenario Blender Expert

skills CLI
$ npx skills add scenario-labs/skills --skill scenario-blender-expert -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install scenario-labs/skills scenario-blender-expert --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/scenario-labs/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dcc/blender/scenario-blender-expert .claude/skills/scenario-blender-expert && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
scenario-blender-expert
GitHub stars
946
Token cost
~3.2k tokens
SKILL.md length
944 words
Files
6 (incl. scripts, references)
Skills in repo
146
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when doing any 3D work in Blender through Python or an MCP bridge, headless or in a live session: modeling, sculpting a character or head, retopology, UV unwrapping, baking…

  • Works in 5 steps: Execution channel → The expert loop (every domain) → Persona pipelines → …
  • Doing any 3D work in Blender through Python
  • SKILL.md covers 1. Execution channel, 2. The expert loop (every…, 3. Persona pipelines and 4. Shared toolkit (scripts/,…, plus 2 more sections
  • Runs Python scripts from its folder; calls npx

What it does

Scenario Blender Expert is an agent skill from scenario-labs/skills. Use when doing any 3D work in Blender through Python or an MCP bridge, headless or in a live session: modeling, sculpting a character or head, retopology, UV unwrapping, baking, texturing, rigging, animating, previs, geometry nodes, lighting and rendering, grease pencil, or finishing an AI-generated mesh into a production asset. Also when a bpy script fails on Blender 5.x API changes, a brush or sculpt operator fails or crashes headless, or a result has to be judged like a professional 3D artist would.

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/blender-5.2-deltas.md`, `references/bpy-reliability.md` and `scripts/bx_audit.py`).

It sits in Game Development. It works with Blender, Model Context Protocol and Python. The repository describes itself as: Get production-ready images, video, audio, and 3D from any AI agent: skills that pick the right model, price before spending, and keep characters and brands consistent through… The licence is MIT.

When your agent uses it

  • Doing any 3D work in Blender through Python
  • In a live session: modeling
  • Sculpting a character
  • Lighting and rendering

Example prompts

  • “/scenario-blender-expert”

Requirements

  • Python 3
  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Execution channel
  2. The expert loop (every domain)
  3. Persona pipelines
  4. Shared toolkit (scripts/, all tested on 5.2.1)
  5. Version traps that break most remembered code

What it can do on your machine

Read from SKILL.md and the folder at commit f6f8ab7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Scenario Blender Expert loads about 3.2k tokens when it runs, and up to ~39k if it reads all its reference files. Until then it costs about 133 tokens; SKILL.md has 944 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~133
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~39k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from scenario-labs/skills at commit f6f8ab7, republished under its MIT licence (© scenario-labs). 944 words, ~3,205 tokens.

Download SKILL.mdSave it as .claude/skills/scenario-blender-expert/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
scenario-blender-expert
description
Use when doing any 3D work in Blender through Python or an MCP bridge, headless or in a live session: modeling, sculpting a character or head, retopology, UV unwrapping, baking, texturing, rigging, animating, previs, geometry nodes, lighting and rendering, grease pencil, or finishing an AI-generated mesh into a production asset. Also when a bpy script fails on Blender 5.x API changes, a brush or sculpt operator fails or crashes headless, or a result has to be judged like a professional 3D artist would.
license
MIT

Blender expert (router and agent protocol)

Expert-level Blender work is a loop, not a script: build big to small, and at every stage turn the model, measure it and fix it before adding detail. This skill is the protocol every Blender task follows and the map to the domain skills distilled from Blender Studio artists, Blender Conference talks and top instructors (sources in each skill). If a sibling skill named here is missing from your available skills, ask the user to install it (npx skills add scenario-labs/skills --skill <name>); unattended, proceed from tool schemas and flag the gap.

1. Execution channel

ChannelUse forRules
Live GUI Blender (user's session over the MCP bridge)anything interactive: real sculpt/paint brushes, weight painting, viewport screenshotsOne short, idempotent script per call returning a compact result dict. Get-or-create by name. Never touch objects you did not create. Save a stage backup bpy.ops.wm.save_as_mainfile(filepath=..., copy=True) after each stage.
Headless helper blender -b [file] --factory-startup --python-exit-code 1 -P x.py -- argsrenders, audits, batch ops, anything when no bridge is upAlways --factory-startup: without it the user's add-ons load (on this machine one of them makes network API calls). Without --python-exit-code a failing script still exits 0. Print a final machine-readable result line.

Never open your own GUI Blender window to test things on the user's machine: windows steal focus and pile up. Live work goes through the user's already-running Blender; everything else runs headless, one Blender process at a time per agent (other sessions may be rendering on the same machine).

Check bpy.app.version first; this skill set targets 5.2 LTS. Many tutorials the experts recorded use 2.8x to 4.2 UI: read references/blender-5.2-deltas.md before trusting any remembered operator, brush name or API.

Verified capability matrix (Blender 5.2.1):

ActionHeadlessGUI session
Voxel remesh, QuadriFlow, multires subdivide, modifiers, bmesh, UV ops with edit-mode context, Cycles/EEVEE/Workbench renders, bakingyesyes
bpy.ops.brush.asset_activate, dyntopo toggleyesyes
Brush strokes (sculpt.brush_stroke, paint.image_paint, paint.weight_paint)no (poll fails)yes, via scripts/bx_gui.py
paint.mask_flood_fill, sculpt.mesh_filterCRASHES Blenderyes, via bx_gui.run()
Programmatic sculpting on mesh datayes, scenario-blender-sculpting/scripts/bx_sculpt.pyyes

2. The expert loop (every domain)

  1. Establish the brief in numbers: purpose (film, game engine, still, animation), budgets (tris, texture size, frame range), style (stylized or realistic), references. When the brief is silent, choose a documented default from the domain skill and write it down.
  2. Plan the stages the domain skill defines. Never start with detail.
  3. Build one stage with the smallest scripts that do it.
  4. Gate the stage: run the measurable checks (scripts/bx_audit.py for meshes, the domain's own checks) AND render a review sheet (scripts/bx_review.py: silhouette, matcap, wire from front/side/three-quarter/low) and open it with the image reader. Experts orbit constantly; the review sheet is the agent's orbit. Judge with the domain's references/critique.md.
  5. Fix before advancing. A problem found at blockout costs one script; found after texturing it costs the stage.
  6. Deliver with evidence: final renders, audit numbers, and what was not verified.

Never report a model, rig, animation or render as done without having looked at a render of it.

Show full SKILL.md (435 more words)Show less

3. Persona pipelines

Persona / briefSkill chainDeliverable
Character artist, stylized or realisticscenario-blender-sculpting, scenario-blender-retopology, scenario-blender-uv-baking, scenario-blender-texturing-shading, scenario-blender-hairsculpt, animation-ready low poly, UVs, baked maps, materials
AI-mesh finisher (Scenario 3D output to production)audit the generated mesh, scenario-blender-retopology (or cleanup + remesh), scenario-blender-uv-baking (bake FROM the generated high), scenario-blender-texturing-shading; generation itself: scenario-3dclean, UV'd, baked asset at a stated budget
Game asset artistscenario-blender-hard-surface or scenario-blender-sculpting, scenario-blender-retopology (game budget), scenario-blender-uv-baking, scenario-blender-texturing-shadinglow poly + PBR set, exported glTF/FBX
Rigger / character TDscenario-blender-riggingrig with controls, weights, deformation tests
Animatorscenario-blender-previs-storyboard (shot planning), scenario-blender-animationblocked, splined, polished shot + playblast
Story / previs artistscenario-blender-previs-storyboard, scenario-blender-grease-pencilshots, cameras, animatic
Look-dev and lighting artistscenario-blender-texturing-shading, scenario-blender-lighting-renderinglit, color-managed, composited renders
Technical artist / proceduralscenario-blender-geometry-nodesnode-group assets, procedural systems
2D / 2.5D animatorscenario-blender-grease-pencilGP animation

Related skills outside this set: scenario-3d (generate meshes to finish here), scenario-textures (AI textures), text-image-to-blender-blockout (camera-locked blockouts for render-to-real video).

4. Shared toolkit (scripts/, all tested on 5.2.1)

  • bx_audit.py: audit(obj, high=None) returns quads %, n-gons, poles (valence 3 / 5+ / 6+), non-manifold, loose, duplicates, flipped faces, self-intersections, boundary loops, symmetry %, edge-length CV, and fidelity to a high poly; verdict(report) lists problems. CLI: blender -b f.blend --python bx_audit.py -- --object Name [--high Sculpt] [--json out.json].
  • bx_review.py: review(objs, out_dir, views, modes) writes one contact sheet (rows = modes, cols = views) in a temporary scene, user settings untouched; playblast(path); turntable(obj, path).
  • bx_gui.py: real brushes in a live session: set_view, activate_brush(mode, name), stroke(mode, world_points, size, strength), run(op, **kw), set_paint_color, screenshot.

Import pattern: import sys; sys.path.append("<this skill>/scripts"); import bx_audit, bx_review.

5. Version traps that break most remembered code

  • Brushes are assets (4.3): bpy.ops.brush.asset_activate(asset_library_type='ESSENTIALS', asset_library_identifier="", relative_asset_identifier="brushes/essentials_brushes-mesh_sculpt.blend/Brush/Clay Strips"); brush size is a diameter (5.0); Flatten/Fill/Scrape merged into the Plane type.
  • Auto Smooth removed (4.1): mesh.shade_smooth() / Smooth by Angle modifier; voxel remesh output is flat-shaded until you call shade_smooth().
  • Principled BSDF v2 (4.0): address sockets by name; Emission strength defaults to 0.
  • BLENDER_EEVEE is the EEVEE Next identifier in 5.x (BLENDER_EEVEE_NEXT fails).
  • Compositor is a node group (5.0): scene.compositing_node_group, not scene.node_tree.
  • Video output: set image_settings.media_type = 'VIDEO' before file_format = 'FFMPEG' (5.0).
  • Slotted actions (4.4), action.fcurves removed (5.0): use bpy_extras.anim_utils.action_get_channelbag_for_slot(action, slot).
  • Bone collections replace armature layers (4.0); Grease Pencil v3 is GREASEPENCIL with bpy.ops.grease_pencil.* (4.3).
  • Positional context dicts for operators are gone: with bpy.context.temp_override(...).
  • obj.matrix_world is stale right after setting location/scale until view_layer.update().

References

  • references/bpy-reliability.md: checklist and tested procedures for reliable bpy (operators vs data API, stale references, evaluated vs original data, idempotent headless jobs, numpy bulk access, node trees, persistence). Load before writing any non-trivial script.
  • references/blender-5.2-deltas.md: full, cited list of what changed from 2.8x to 5.2 per domain (load before writing code from memory or following an old tutorial).

© scenario-labs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/dcc/blender/scenario-blender-expert of scenario-labs/skills.

  • SKILL.md
  • references/blender-5.2-deltas.md
  • references/bpy-reliability.md
  • scripts/bx_audit.py
  • scripts/bx_gui.py
  • scripts/bx_review.py

Open the folder on GitHubat commit f6f8ab7

Compare with similar skills

Scenario Blender Expert next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Scenario Blender Expert compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scenario Blender Expert this skillscenario-labs/skills946—~3.2kAutomated safety check: PassMIT
Text To 3D AssetLaurentiuGabriel/unreal-game-assets-creation-skill148—~2.1kAutomated safety check: PassNone
Fmodel Unpackpa001024/dna-builder137—~2.6kAutomated safety check: PassMIT
Unity CLIAmaniDawn/DGame169—~554Automated safety check: PassMIT
Blender Web Export Pipelinefreshtechbro/claudedesignskills1k—~4.2kAutomated safety check: PassMIT
Unreal Enhanced Input Setupkevinpbuckley/VibeUE730—~2.4kAutomated safety check: PassMIT

Similar skills

  • Text To 3D Asset

    LaurentiuGabriel/unreal-game-assets-creation-skill

    Generate a game-ready 3D asset by running the local AI pipeline sequentially: Fooocus (SDXL text-to-image) - Hunyuan3D-2 (image-to-textured-GLB) - optional Blender FBX convert + Unreal import.

    148 GitHub stars~2.1k tokensUpdated 2 mo ago
    Game DevelopmentAuto-check passed
  • Fmodel Unpack

    pa001024/dna-builder

    This skill documents how to use the fmodel-mcp toolkit (a CUE4Parse-based .NET CLI plus a thin Python MCP server) to inspect and export Unreal Engine game assets — pak files, textures, meshes…

    137 GitHub stars~2.6k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Unity CLI

    AmaniDawn/DGame

    安装和修复 DGame Unity CLI,使用内嵌 Pipeline 与项目级 Workflow 排查 CLI/MCP 连接,查询 Unity Editor/Development Player,执行编译、测试和受控验证。涉及 CLI 安装、连接配置或实际 Unity 状态时使用;纯源码或文档任务不连接 Editor。

    169 GitHub stars~554 tokensUpdated 4 days ago
    Game DevelopmentAuto-check passed
  • Blender Web Export Pipeline

    freshtechbro/claudedesignskills

    Exports and optimizes Blender 3D models and animations for the web as glTF, covering batch Python scripting, texture baking, decimation and LOD generation for Three.js and Babylon.js.

    1k GitHub stars~4.2k tokensUpdated 10 mo ago
    Game DevelopmentAuto-check passed
  • Unreal Enhanced Input Setup

    kevinpbuckley/VibeUE

    Creates and wires Unreal Engine Enhanced Input assets through VibeUE's InputService: Input Actions, Mapping Contexts, key bindings, triggers and modifiers.

    730 GitHub stars~2.4k tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed
  • Blender Addon Dev

    TerminalSkills/skills

    Build custom Blender add-ons with Python. An agent skill from TerminalSkills/skills.

    163 GitHub stars~2k tokensUpdated 7 days ago
    Game DevelopmentAuto-check passed

More from scenario-labs/skills

All 146 skills in this repo
  • Scenario Blender Grease Pencil

    scenario-labs/skills

    A skill your agent uses when drawing or animating with Grease Pencil in Blender 5.x from Python: 2D or 2.5D illustration, frame-by-frame animation, a cutout or part-based 2D character, strokes with…

    946 GitHub stars~4.5k tokensUpdated yesterday
    Auto-check passed
  • Scenario Blender Hair

    scenario-labs/skills

    A skill your agent uses when grooming hair or fur in Blender with hair curves, such as a character hairstyle, animal fur, procedural fur in geometry nodes, or hair cards and mesh hair for games.

    946 GitHub stars~4.7k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when lighting, rendering or compositing in Blender: light a character, product or hero shot, interior at dusk or night, three-point or motivated lighting, sun and sky, HDRI…

    946 GitHub stars~5k tokensUpdated yesterday
    Auto-check passed
  • Scenario Chatgpt Pet Create

    scenario-labs/skills

    A skill your agent uses when creating a ChatGPT pet or Codex pet with Scenario: hatching an animated companion from a text idea, a character, mascot or brand cue, or reference photos and art; making…

    946 GitHub stars~3.6k tokensUpdated yesterday
    Auto-check passed
  • Scenario Godot Animation

    scenario-labs/skills

    A skill your agent uses when animating characters or scenes in Godot 4.7: AnimationPlayer clips and RESET, AnimationTree state machines and blend spaces built in code, Mixamo or glTF import, loop…

    946 GitHub stars~4.7k tokensUpdated yesterday
    Auto-check passed
  • Scenario Godot Audio

    scenario-labs/skills

    A skill your agent uses when adding or fixing sound in Godot 4.7: audio buses and effects, volume sliders, 'too many sounds', combat audio with hundreds of enemies, sounds clipping or distorting, 3D…

    946 GitHub stars~4.7k tokensUpdated yesterday
    Auto-check passed

Questions about Scenario Blender Expert

What does Scenario Blender Expert do?

A skill your agent uses when doing any 3D work in Blender through Python or an MCP bridge, headless or in a live session: modeling, sculpting a character or head, retopology, UV unwrapping, baking…. Scenario Blender Expert is an agent skill from scenario-labs/skills. Use when doing any 3D work in Blender through Python or an MCP bridge, headless or in a live session: modeling, sculpting a character or head, retopology, UV unwrapping, baking, texturing, rigging, animating, previs, geometry nodes, lighting and rendering, grease pencil, or finishing an AI-generated mesh into a production asset.

When should I use Scenario Blender Expert?

Scenario Blender Expert fits situations like: doing any 3D work in Blender through Python; in a live session: modeling; sculpting a character; lighting and rendering.

How do I install Scenario Blender Expert in Claude Code?

Run `npx skills add scenario-labs/skills --skill scenario-blender-expert -a claude-code`. Or copy the skill folder (skills/dcc/blender/scenario-blender-expert in scenario-labs/skills) into .claude/skills/scenario-blender-expert in your project. Claude Code loads it when a task matches its description.

How do I install Scenario Blender Expert in Codex?

Run `npx skills add scenario-labs/skills --skill scenario-blender-expert -a codex`. Or copy the skill folder (skills/dcc/blender/scenario-blender-expert in scenario-labs/skills) into .agents/skills/scenario-blender-expert in your project. Codex loads it when a task matches its description.

Can I use Scenario Blender Expert in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add scenario-labs/skills --skill scenario-blender-expert -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scenario-blender-expert, .gemini/skills/scenario-blender-expert, .github/skills/scenario-blender-expert and .opencode/skills/scenario-blender-expert in your project.

What does Scenario Blender Expert need to run?

Going by SKILL.md and its folder, Scenario Blender Expert needs Python for the scripts in its folder and the command-line tools its instructions call (npx). Our summary lists: Python 3; Node.js.

Does Scenario Blender Expert access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Scenario Blender Expert safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Scenario Blender Expert use?

Scenario Blender Expert is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Scenario Blender Expert use?

About 3.2k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 36k tokens, read only when the agent opens those files.

What are the alternatives to Scenario Blender Expert?

Skills that share tags, products or a category with Scenario Blender Expert: Text To 3D Asset (LaurentiuGabriel/unreal-game-assets-creation-skill, 148 stars), Fmodel Unpack (pa001024/dna-builder, 137 stars), Unity CLI (AmaniDawn/DGame, 169 stars) and Blender Web Export Pipeline (freshtechbro/claudedesignskills, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scenario Blender Expert?

scenario-labs (a GitHub organization) maintains it in scenario-labs/skills, which has 946 GitHub stars. The repository holds 146 skills in this directory. The repository was last updated on October 10, 2026.

Source: scenario-labs/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.