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

blender-addon-development — скилл для Blender: разработка и установка

Скилл blender-addon-development для Claude Code помогает создавать и исправлять расширения Blender. Включается при работе над аддоном, инструментом или интерфейсом.

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

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

Что делает blender-addon-development

Скилл помогает разрабатывать расширения Blender 5.3: готовить манифест blender_manifest.toml, операторы и элементы интерфейса, настраивать свойства, отмену действий и отрисовку через gpu. Он также разбирает сборку, проверку и установку расширения командами Blender и тестирование в headless-режиме.

Внутри есть шаблон с файлами __init__.py, operators.py и ui.py, а также порядок регистрации и снятия классов, обработчиков, таймеров и горячих клавиш. Для сторонних Python-пакетов нужны .whl в ./wheels/ и записи в манифесте; устанавливать их через pip во время работы расширения нельзя. При публикации на extensions.blender.org требуется GPL-совместимая лицензия.

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

  • создать расширение Blender с манифестом и интерфейсом
  • настроить операторы с отменой и повтором действий
  • проверить и собрать расширение командами Blender
  • протестировать регистрацию аддона в headless-режиме
  • подготовить расширение к публикации на extensions.blender.org

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

  • Создай расширение Blender 5.3 с оператором и панелью в N-панели.
  • Проверь свойства bpy.props и регистрацию классов в моём аддоне.
  • Подготовь команды для проверки и сборки расширения ./my_tool.

Как установить blender-addon-development

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-addon-development -a claude-code

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

~/.claude/skills/blender-addon-development/SKILL.md

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

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

Вопросы о blender-addon-development

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

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

Что делает blender-addon-development?

Скилл помогает создавать и исправлять расширения Blender: от манифеста и интерфейса до сборки, тестирования и публикации.

Что нужно для сторонних Python-пакетов в расширении?

Положи файлы .whl в ./wheels/ и перечисли их в манифесте. Установка пакетов через pip во время работы расширения запрещена.

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

SKILL.md · MIT
---
name: blender-addon-development
description: Write Blender 5.3 add-ons as extensions - blender_manifest.toml, operators/panels/menus/property groups/preferences, bpy.props rules after 5.0, undo/redo, modal and timer patterns, gpu drawing (no bgl), bundling Python wheels, CLI validate/build/install, testing headless, extensions platform publishing. Use when creating or fixing a Blender add-on, tool, or UI.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Add-on (Extension) Development

The execution model is in `blender-core`. Start from `assets/addon_template/` (validated, built, and registered in CI): `blender_manifest.toml`, `__init__.py`, `operators.py`, `ui.py`.

## Procedure
1. Copy the template, then set `id` (lowercase_underscores, permanent), `name`, `tagline` (no trailing period, ≤ 64 chars), `maintainer`, `version` (semver), `license` (SPDX, GPL-3.0-or-later for code using bpy), and `blender_version_min = "4.2.0"` or higher if you use newer APIs (e.g. `"5.2.0"` for the GN `properties.inputs` API).
2. Write classes with the prefix convention `MYTOOL_OT_x` (operator), `_PT_` (panel), `_MT_` (menu), `_PG_` (property group), `_AP_` (preferences), `_UL_` (UI list). `bl_idname` for operators is `my_tool.verb_noun`.
3. Validate and build:
   ```
   blender --command extension validate ./my_tool
   blender --command extension build --source-dir ./my_tool --output-dir ./dist
   blender --command extension install-file -r user_default -e ./dist/my_tool-1.0.0.zip
   ```
4. Test headless: register the package in-process, call operators with `temp_override`, and assert on data (see `tests/test_addon.py` in this repo).

## Rules (extension-era, 5.x)
- **Relative imports only** (`from . import ops`). The package name is decided by Blender, so preferences use `bl_idname = __package__`.
- No `bl_info` (it's ignored for extensions). Everything goes in the manifest.
- **No network or file access at import/register time.** Declare `[permissions]` (`files`, `network`, `clipboard`, `camera`, `microphone`) with a reason. Check `bpy.app.online_access` before any network call.
- **Third-party Python packages**: ship `.whl` files in `./wheels/` and list them under `wheels = [...]`. Never `pip install` at runtime. Platform-specific wheels require `platforms = [...]`.
- **Properties (5.0+)**: `bpy.props` values are attributes, not dict entries (`scene["my_prop"]` no longer reaches them). For read-only props use `options={'READ_ONLY'}`. `get_transform`/`set_transform` adapt values while keeping storage. Register with `PointerProperty(type=PG)` on an ID type, and `del` it on unregister.
- **Operators**: `bl_options={"REGISTER","UNDO"}` for undo plus a redo panel. `poll()` guards the context. Return `{"FINISHED"}`/`{"CANCELLED"}`. `self.report({"WARNING"}, msg)` for user feedback. Don't call other operators in loops if a data API exists.
- **UI**: `layout.use_property_split = True` gives modern alignment. Panels in the N-panel use `bl_region_type="UI"` + `bl_category`. Append menu entries with `VIEW3D_MT_*.append(func)` and remove them on unregister.
- **Unregister** everything in reverse order (classes, props, menus, handlers, timers, keymaps, draw handlers). Leaks break reloading.
- **Drawing** (overlays): `gpu` module + `gpu_extras.batch`. `bgl` was removed in 5.0. Textures come from `gpu.texture.from_image(img)`. For scene-linear images use `draw_texture_2d(..., is_scene_linear_with_rec709_srgb_target=True)`.
- **Long tasks**: a modal operator with a timer (`wm.event_timer_add`), or `bpy.app.timers.register` with chunked work. Never block the UI for seconds.
- **Handlers**: decorate persistent ones with `@bpy.app.handlers.persistent`. Keep them cheap (they run every frame/depsgraph update).
- **Keymaps**: add them to `wm.keyconfigs.addon`, store `(km, kmi)` pairs, and remove them on unregister.
- **Translations / i18n**: `bpy.app.translations.register(__package__, dict)`.

## Publishing (extensions.blender.org)
The Blender ID account uploads the built zip. Requirements: a valid manifest, a GPL-compatible license, no obfuscated code, no bundled binaries without source, and permissions declared. Screenshots/README go on the website listing. Update with a higher `version`.

## Gotchas
- `context.scene` inside a draw function can be `None` in some editors. Guard it.
- Storing Blender data references (`bpy.types.ID`) in Python globals crashes after undo or file load. Store names or `session_uid`, and look them up again.
- `bpy.utils.register_class` fails if annotations use `=` instead of `:` for properties.
- 5.0 made several bundled modules private (`rna_info`, `bl_ui_utils`...). Don't import them.
- 5.1 no longer loads the user site-packages by default. Bundle wheels instead of relying on user installs.
- 5.2: `PreferencesFilePaths.active_asset_library` indices are offset (the "All"/"Essentials" entries come first). `UILayout.template_palette(color=)` is removed. New: `UILayout.link`, `UILayout.textbox`, `bpy.data.all_ids`, `Window.screenshot`.
- 5.3: `bpy.data.all_ids` order is an implementation detail. New: `UILayout.label_multiline()`, `auto_keymap=` on `invoke_popup`/`popover`, `window_manager.undo_stack` (read-only), `constraints.new(type, name=)`, `KDTree(n, dimensions=2)`, `gpu.types.GPUStorageBuf`, and bundled `OpenEXR`/`opentimelineio` modules. Vulkan is the default GPU backend on Windows/Linux, so test `gpu` drawing there.

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

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
blender-python-addon Mindrally Скилл blender-python-addon для Claude Code задаёт правила разработки дополнений к Blender через API bpy. Подключается при создании операторов, панелей интерфейса и работе с bmesh. CX Codex +1 111установок blender-motion-state-inspection affaan-m Скилл blender-motion-state-inspection для Claude Code извлекает параметры скелета, костей и контактов в Blender. Проверяет скольжение ног, проваливание в пол и инверсию осей ретаргетинга. CX Codex +1 7 000установок blender-web-pipeline freshtechbro Скилл blender-web-pipeline настраивает экспорт 3D-моделей из Blender в веб-формат glTF 2.0. Он помогает автоматизировать сжатие геометрии, запекание текстур и пакетную обработку сцен. CX Codex +1 4 100установок blender-modeling RobLe3 Скилл blender-modeling для ИИ-агента: создаёт и правит 3D-меши в Blender по текстовому запросу — примитивы, модификаторы, bmesh-правки. CX Codex +1 4 100установок blender-materials RobLe3 Скилл blender-materials для Claude Code: создаёт и назначает PBR-материалы в Blender через Principled BSDF — металл, стекло, пластик, ткань, кожу. Выполняет запросы «как медь» или «матовую поверхность». CX Codex +1 3 100установок Blender SFKislev Скилл Blender для Claude Code управляет открытой сценой Blender через локальный мост Flue. Агент читает объекты и материалы, а также выполняет небольшие скрипты bpy по запросу. CX Codex +1 2 900установок

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

Весь набор →
blender-pipeline-automation Скилл blender-pipeline-automation для Claude Code автоматизирует пакетную обработку файлов Blender и работу с библиотеками. Он запускает конвертацию, инвентаризацию и пользовательские скрипты для папок с 3D-файлами. CX Codex +1 509установок 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-stylized-npr Скилл blender-stylized-npr для Claude Code настраивает NPR-стилизацию в Blender: тонирование, контуры и Grease Pencil. Включается для аниме-, мультяшных и комиксных моделей и стилизованных объектов для игровых движков. CX Codex +1 458установок blender-texturing Скилл blender-texturing для Claude Code автоматизирует создание текстур и слоёв умных материалов в Blender 5.3. Запускается при настройке износа, грязи или декалей на 3D-моделях. CX Codex +1 431установок blender-environment-kits Скилл blender-environment-kits для Claude Code собирает игровые окружения в Blender 5.3: рельеф, биомы и модульные наборы. Включается при создании уровней, лесов, зданий или подземелий. CX Codex +1 424установок blender-clothing Скилл blender-clothing для Claude Code автоматизирует создание игровой одежды в Blender 5.3. Извлекает геометрию из полисетки тела, переносит веса костей и устраняет сквозные пробивания ткани. CX Codex +1 416установок

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

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