К основному содержанию
скилл CX Codex

blender-pipeline-automation — скилл для Claude Code

Скилл blender-pipeline-automation для Claude Code автоматизирует пакетную обработку файлов Blender и работу с библиотеками. Он запускает конвертацию, инвентаризацию и пользовательские скрипты для папок с 3D-файлами.

MIT 509 установок ★ 2 624 обновлён 2026-11-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/blender-skills --skill blender-pipeline-automation -a claude-code
Открыть на GitHub

Что делает blender-pipeline-automation

Скилл помогает запускать Blender без интерфейса для пакетной конвертации .blend, .fbx, .glb, .obj и .usd, инвентаризации файлов и выполнения скриптов. Результаты и ошибки пакетных задач выводятся в JSON; задания можно распределять между процессами через --shard.

Для работы с данными Blender описаны загрузка и связывание библиотек, поиск внешних путей, перенос файлов и очистка неиспользуемых данных. Скилл также разбирает запуск bpy как Python-модуля, настройку путей и шаблон CI на GitHub Actions. Для bpy нужен Python 3.13, соответствующий версии Blender; GPU в контейнере для Cycles CUDA/OptiX требует NVIDIA container runtime, а EEVEE — GPU/EGL даже без интерфейса.

Какие задачи решает

  • конвертировать папку с .fbx в .glb
  • составить JSON-инвентаризацию .blend-библиотеки
  • запустить QA-скрипт для коллекции файлов
  • разбить пакетную обработку между процессами
  • перенести внешние пути в файлах Blender

Примеры запросов агенту

  • Пакетно конвертируй файлы из assets/**/*.fbx в glb и сохрани их в export/.
  • Составь JSON-инвентаризацию файлов в library/.
  • Запусти qa_check.py для файлов из src/*.blend с профилем game.

Как установить blender-pipeline-automation

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-pipeline-automation -a claude-code

2Вручную: положить файлы

~/.claude/skills/blender-pipeline-automation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/blender-pipeline-automation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о blender-pipeline-automation

Как установить blender-pipeline-automation в Claude Code?

Выполни npx skills add EL4CTEO/blender-skills --skill blender-pipeline-automation -a claude-code. Файл скилла находится по пути ~/.claude/skills/blender-pipeline-automation/SKILL.md.

Что делает blender-pipeline-automation?

Он помогает автоматизировать пакетную обработку файлов Blender: конвертацию, инвентаризацию и запуск скриптов. Также описывает работу с библиотеками, путями и CI.

Что нужно для работы blender-pipeline-automation?

Для использования bpy как Python-модуля нужен Python 3.13 и версия пакета, соответствующая целевой версии Blender. Для Cycles CUDA/OptiX в контейнере требуется NVIDIA container runtime; для EEVEE — GPU/EGL.

Исходный текст

SKILL.md · MIT
---
name: blender-pipeline-automation
description: Automate Blender 5.3 at scale - headless CLI flags, batch convert/inventory/run-any-skill-script over folders of .blend/.fbx/.glb/.obj/.usd, sharding, bpy pip module, library linking, path management, render-farm and CI patterns. Use for batch jobs, format conversion, library maintenance and pipeline tooling.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Pipeline Automation

The execution model is in `blender-core` (`run_in_blender.py` finds Blender and prints only the JSON results).

## Batch one-liners
```
blender -b -P scripts/batch_process.py -- --in "assets/**/*.fbx" --op convert --to glb --out export/
blender -b -P scripts/batch_process.py -- --in library/ --op report                      # inventory JSON lines
blender -b -P scripts/batch_process.py -- --in "src/*.blend" --op script \
    --script ../blender-asset-qa/scripts/qa_check.py --kwargs '{"profile":"game"}'       # QA a whole library
blender -b -P scripts/batch_process.py -- --in src/ --op script --script ../blender-game-optimization/scripts/make_lods.py \
    --kwargs '{"rename":true}' --save-to processed/                                      # LODs for every file
```
Each file is streamed as one JSON line with `ok`, timing and results. Failures don't stop the batch, and the summary lists them. **Parallel**: start N processes with `--shard 0/N` … `--shard N-1/N` (Blender uses one core for Python, so processes scale with CPU/GPU count).

## Headless CLI essentials
| Flag | Meaning |
|---|---|
| `-b` | background, no UI. Put it **first** |
| `file.blend` | open before running scripts. Order matters: args run left to right |
| `-P script.py` / `--python-expr "..."` | run Python |
| `--python-exit-code 1` | non-zero exit if the script raises (CI) |
| `--factory-startup` | ignore user prefs/add-ons (reproducible). Bundled add-ons still load |
| `--addons rigify,io_scene_fbx` | enable specific add-ons |
| `-E CYCLES -o //out/#### -F PNG -s 1 -e 10 -a` / `-f 5` | render (`blender-rendering`) |
| `--command extension build/validate/install-file` | extension tooling (`blender-addon-development`) |
| `-- --my args` | everything after `--` goes to the script (`sys.argv[sys.argv.index("--")+1:]`) |
| `--log "*"`, `--debug-python` | debugging. 5.0 changed the log format, so don't regex progress lines |
Environment variables: `BLENDER_USER_SCRIPTS`, `BLENDER_USER_EXTENSIONS`, `BLENDER_SYSTEM_PYTHON`. Use `OCIO` for custom color configs.

## bpy as a Python module
`pip install bpy==5.3.*` (or `5.2.*` for the LTS) (Python 3.13, matching the Blender release) gives `import bpy` in plain Python, which is handy for pytest/CI/web services. It has no UI and no GPU module by default, and it's large (~300 MB). Version-lock it with the Blender you target. The `bpy` wheel and the CLI behave the same for data API work.

## Library patterns
- **Append/link**: `bpy.data.libraries.load(path, link=...)` (see `blender-core/references/bpy-patterns.md`). 5.2: `data_from.libraries` exposes nested library paths when loading.
- **Write a subset**: `bpy.data.libraries.write(path, {datablocks}, fake_user=True, path_remap="RELATIVE_ALL")` builds asset/library files from a session.
- **Find files**: `bpy.data.file_path_foreach(...)` (5.2 flags: `EXPAND_TOKENS` for UDIMs, `EXPAND_SEQUENCES`, `EXPAND_CACHES`), and `bpy.utils.blend_paths(absolute=True)` lists every external path.
- **Remap/relocate**: `bpy.ops.file.find_missing_files(directory=...)`, `make_paths_relative`, `pack_all`. Libraries: `lib.filepath = new; lib.reload()`.
- **Iterate every ID**: `bpy.data.all_ids` (5.2; order isn't stable in 5.3, so sort by name if output must be deterministic), and `bpy.data.orphans_purge(do_recursive=True)` for cleanup.

## Robustness rules
- One task per process where possible. Long Blender sessions leak (images, undo). `batch_process.py` reuses the process but resets with `read_factory_settings(use_empty=True)` / `open_mainfile`.
- Never write into the source folder by default. Use separate `--out`/`--save-to`, and write with `copy=True`.
- Make scripts idempotent: re-running replaces their own outputs (named prefixes, `exist_ok`).
- Log JSON, not prose: one object per file/job, so agents and CI can parse it cheaply.
- Pin the Blender version (5.2 LTS, or 5.3) for a project. Record `bpy.app.version_string` + hash (`bpy.app.build_hash`) in the outputs.
- Paths: `bpy.path.abspath("//x")` is relative to the **opened** .blend. In headless batches use absolute paths, or set them after `open_mainfile`.
- GPU in containers: Cycles CUDA/OptiX needs the NVIDIA container runtime. Otherwise use CPU. EEVEE needs a GPU/EGL even headless.

## CI recipe (GitHub Actions)
Download the Linux tarball (`https://download.blender.org/release/Blender5.3/blender-5.3.0-linux-x64.tar.xz`), cache it, then `blender -b --factory-startup --python-exit-code 1 -P tests/run_all.py`. This repo's `.github/workflows/ci.yml` is a working example.

© blender-agent-skills · MIT · EL4CTEO/blender-skills

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
scenario-zbrush-automation scenario-labs Скилл scenario-zbrush-automation автоматизирует пакетную обработку файлов в ZBrush 2026: импорт OBJ и ZTL, скрипты, экспорт SubTools, GoZ-обмен с Maya и Blender. Решает проблемы зависания плагинов и диалогов, которые стопорят скрипты. CX Codex +1 430установок blender-web-pipeline-pipeline Claude Design Skillstack Субагент blender-web-pipeline-pipeline готовит пайплайн экспорта 3D-ассетов из Blender в веб, автоматизирует пакетную обработку и сжатие текстур. CX Codex ★ 1 428звёзд репо blender-web-pipeline freshtechbro Скилл blender-web-pipeline настраивает экспорт 3D-моделей из Blender в веб-формат glTF 2.0. Он помогает автоматизировать сжатие геометрии, запекание текстур и пакетную обработку сцен. CX Codex +1 4 100установок blender-forest mromidev Скилл blender-forest для Claude Code воспроизводит реалистичные 3D-сцены природы в Blender по шагам из видеоуроков с YouTube. Применяется для генерации леса, дорог, риггинга авто и настройки рендера. CX Codex +1 ★ 182звёзд репо blender-motion-state-inspection affaan-m Скилл blender-motion-state-inspection для Claude Code извлекает параметры скелета, костей и контактов в Blender. Проверяет скольжение ног, проваливание в пол и инверсию осей ретаргетинга. CX Codex +1 7 000установок blender-modeling RobLe3 Скилл blender-modeling для ИИ-агента: создаёт и правит 3D-меши в Blender по текстовому запросу — примитивы, модификаторы, bmesh-правки. CX Codex +1 4 100установок

Из того же набора28

Весь набор →
blender-scene-setup Скилл blender-scene-setup для Claude Code настраивает и проверяет сцены Blender. Запускается при создании проекта, уборке файла .blend и подготовке к передаче или экспорту. CX Codex +1 558установок blender-sculpting Скилл blender-sculpting для Claude Code управляет процедурным скульптингом в Blender 5.3 для персонажей и органических форм. Включается при создании базовых сетк, проработке деталей и подготовке запекания. CX Codex +1 558установок blender-facial-shapekeys Скилл blender-facial-shapekeys для Claude Code настраивает лицевые риги и шейп-кеи в Blender 5.3 для ARKit 52 и экспорта в движки. Запускается при подготовке трехмерных персонажей к анимации или экспорту. CX Codex +1 548установок blender-workflow-recipes Скилл blender-workflow-recipes для Claude Code и Cursor собирает пайплайны для Blender 5.3 с этапами контроля качества и обработки моделей. Запускается на каждый запрос по многостадийной обработке активов. CX Codex +1 543установок blender-simulation Скилл blender-simulation для Claude Code и других платформ, автоматизирующий физические симуляции в Blender 5.3. Запускает скрипты для настройки жёстких тел, ткани, жидкостей и рендеринга без графического интерфейса. CX Codex +1 504установок blender-time-of-day Скилл blender-time-of-day для Claude Code, управляющий освещением и атмосферой сцены в Blender 5.3. Выбирает время суток и погодные условия, настраивая параметры неба, солнца, тумана и композитора. CX Codex +1 489установок blender-weather-fx Скилл blender-weather-fx для Claude Code создаёт погодные эффекты в сценах Blender 5.3. Добавляет осадки, мокрые поверхности, лужи, снег или молнии по запросу на сцену с погодой. CX Codex +1 476установок blender-addon-development Скилл blender-addon-development для Claude Code помогает создавать и исправлять расширения Blender. Включается при работе над аддоном, инструментом или интерфейсом. CX Codex +1 463установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой