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

blender-facial-shapekeys — скилл для Claude Code

Скилл blender-facial-shapekeys для Claude Code настраивает лицевые риги и шейп-кеи в Blender 5.3 для ARKit 52 и экспорта в движки. Запускается при подготовке трехмерных персонажей к анимации или экспорту.

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

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

Что делает blender-facial-shapekeys

Этот скилл автоматизирует создание и проверку лицевых шейп-кеев в Blender 5.3, включая ARKit 52, виземы и гибридные риги из костей и блендшейпов. Скрипты пакета создают заготовки ключей, разделяют симметричные формы на левую и правую стороны, зеркалят блендшейпы и проверяют готовность сетки к экспорту в Unity, Unreal, Roblox или web-форматы.

Перед началом работы требуется подготовленная сетка головы с чистой топологией вокруг глаз и рта. Менять базовую топологию после создания ключей нельзя, так как это разрушает всю анимационную сетку. Модификатор подразделения поверхности должен стоять после шейп-кеев, а применение модификаторов напрямую на сетке с ключами вызовет ошибку.

Агент подключает этот скилл, когда пользователь просит настроить мимику, блендшейпы, лип-синк или подготовить голову персонажа для игры или веб-просмотра.

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

  • создать заготовки шейп-кеев для ARKit 52 и виземов
  • зеркалить и разделять симметричные выражения лица
  • добавить контроллеры и драйверы для анимации
  • проверить пропущенные ключи и ошибки сетки
  • экспортировать модель в Unity, Unreal и VRM

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

  • Создай ARKit 52 шейп-кеи для головы персонажа в Blender
  • Раздели симметричные формы для глаз и рта на левую и правую стороны
  • Добавь драйверы и контроллеры к шейп-кеям мимики

Как установить blender-facial-shapekeys

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-facial-shapekeys -a claude-code

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

~/.claude/skills/blender-facial-shapekeys/SKILL.md

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

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

Вопросы о blender-facial-shapekeys

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

Выполните команды npx skills add EL4CTEO/blender-skills --skill blender-facial-shapekeys -a claude-code и ~/.claude/skills/blender-facial-shapekeys/SKILL.md.

Что делает blender-facial-shapekeys?

Скилл автоматизирует создание, зеркалирование, проверку шейп-кеев и лицевых ригов в Blender 5.3 для игровых движков и веб-форматов.

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

Для работы требуется установленный Blender 5.3 и сеточные модели с чистой топологией вокруг рта и глаз.

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

SKILL.md · MIT
---
name: blender-facial-shapekeys
description: Facial rigs and shape keys in Blender 5.3 - ARKit 52 blendshapes, visemes for lip-sync, sculpting expressions, splitting symmetric shapes into Left/Right, mirroring, corrective and combination shapes, drivers and control rigs, bone+blendshape hybrids, export to engines (Unity, Unreal, Roblox dynamic heads, VRM/web). Use for faces, expressions, lip-sync, or any shape-key work.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Facial Rig & Shape Keys

The execution model is in `blender-core`. The body rig is in `blender-character-rigging`.

## Choose the approach
| Approach | Use | Notes |
|---|---|---|
| **Blendshapes (ARKit 52)** | games, VTubers, mocap (iPhone/Live Link Face), web/VRM | the industry interchange set; each shape is sculpted |
| **Bones** (jaw, eyes, lids, brows, lips) | stylized, low memory, mobile | jaw + eyes as bones are almost always right |
| **Hybrid** | most production game heads | jaw/eye/tongue bones + blendshapes for everything soft |
| **Rigify face** (`human` metarig) | film-style keyframe animation inside Blender | 100+ face bones, heavy for engines |

## Procedure (blendshapes)
1. The head mesh needs clean loops around the eyes and mouth (`blender-retopology-uv`), with eyes, teeth and tongue as separate objects parented or weighted to bones.
2. `scripts/shapekeys.py -- --mesh Head --create arkit` (or `--create visemes` for the 15 Oculus visemes) creates empty, correctly named keys.
3. Sculpt each key (live: sculpt mode on the active key, `use_shape_key_edit_mode`). Symmetric expressions can be sculpted once, then `--split eyeBlink` gives `eyeBlinkLeft/Right` with a soft blend across X=0 (`--falloff` m).
4. `--mirror browDownLeft` builds `browDownRight` (topology-independent mirror).
5. `--report` lists unsculpted keys, the max offset per key, and missing ARKit names. A shape is done only when every key moves and nothing is left over.
6. Optional: `--drivers FaceCtrl` adds a controller with 0–1 custom properties driving each key, for keyframing in Blender.
7. Check the extremes and **combinations** (jawOpen + mouthSmile, eyeBlink + eyeSquint) with `look`. Fix them with corrective combination keys driven by the product of two keys.

## Shape key rules
- Shapes are **deltas from Basis**. Never change the Basis topology after creating keys (adding or removing verts destroys every key).
- One action per key. No head or neck movement inside face keys (bones do that). Keep eyelids sliding over the eye surface, not through it (check with `blender-asset-qa` zfighting on lid/eye).
- Range 0–1. `slider_max` can be raised for exaggeration, but engines clamp to 0–1.
- Relative keys (`use_relative=True`, the default) are the only kind that exports.
- Name exactly per spec (case-sensitive): `eyeBlinkLeft`, not `EyeBlink_L`. Engines map by name.
- Keys on meshes with Subdivision: sculpt at level 0, and keep the subdivision modifier **after** the shape keys (they're evaluated first anyway).
- Applying modifiers on a mesh with shape keys fails. Use `modifier_apply_as_shapekey` for deform modifiers, or apply them before creating keys.

## Correctives and combination shapes
- Corrective for a bone pose: sculpt in the posed state, then drive with a `TRANSFORMS` variable (`ROT_X`, `LOCAL_SPACE`, mapped to 0–1).
- Combination: key `jawOpen_mouthSmile` with driver `SCRIPTED` expression `a*b`, from the two key values (`SINGLE_PROP` `key_blocks["jawOpen"].value`). Simple expressions don't need Python auto-run.

## Engine notes
- **Unity**: FBX blendshapes. In the Model importer, set Blend Shape Normals = Calculate (or Import if smoothing was exported). ARKit names map to the AR Foundation face-tracking samples.
- **Unreal**: morph targets ("Import Morph Targets"). Live Link Face / MetaHuman Animator use ARKit names, and the Pose Asset maps the curves. No leaf bones.
- **Roblox dynamic heads**: FACS-based poses with Roblox-specific names, authored as animation frames on a head rig (Creator Hub "Dynamic heads" spec). Build from the official Blender template. ARKit sculpts can be reused by renaming/mapping. Head ≤ 4,000 tris.
- **VRM / web (three-vrm, ReadyPlayerMe-style)**: ARKit 52 + visemes as glTF morph targets (`export_morph=True`). Keep the morph-normal export on only if shading needs it (it doubles the size).
- Drop unused keys before export. Every key costs memory per vertex (glTF sparse accessors help).

## Gotchas
- `ob.shape_key_add(from_mix=False)` copies the Basis. `from_mix=True` bakes the current mix (useful for combos, dangerous by accident).
- `shape_key_mirror(use_topology=False)` needs a mesh symmetric on X. Run it on the **active** key (the script handles this).
- Driver variables on shape keys use the Key ID (`ob.data.shape_keys`), not the mesh: `fc = kb.driver_add("value")`.

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

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
scenario-blender-export scenario-labs Скилл scenario-blender-export для Claude Code и Cursor готовит трехмерные модели из Blender к экспорту в игровые движки и форматы вроде FBX, glTF или USDZ. CX Codex +1 736установок blender-export RobLe3 Скилл blender-export для Claude Code и пяти других платформ, который экспортирует сцены Blender в glTF/GLB, FBX, OBJ, USD и STL с нужными настройками под каждую цель. CX Codex +1 2 600установок blender-image-to-3d majidmanzarpour Скилл blender-image-to-3d для Claude Code собирает игровой 3D-ассет в Blender по референсам через контролируемые фазы с рендером и сравнением. Запускается при упоминании референс-изображения для создания модели. CX Codex +1 917установок 3d-spatial dylantarre Скилл 3d-spatial переносит 12 классических принципов анимации Диснея в 3D, VR и AR. Помогает настроить физику, сплайны и тайминги в Blender, Unity или Unreal Engine. CX Codex +1 861установок scenario-blender-expert scenario-labs Скилл scenario-blender-expert для Claude Code помогает автоматизировать Blender через Python и MCP: моделировать, запекать, настраивать риг и проверять меши перед экспортом. CX Codex +1 1 700установок blender-motion-state-inspection affaan-m Скилл blender-motion-state-inspection для Claude Code извлекает параметры скелета, костей и контактов в Blender. Проверяет скольжение ног, проваливание в пол и инверсию осей ретаргетинга. CX Codex +1 7 000установок

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

Весь набор →
blender-rendering Скилл blender-rendering для Claude Code настраивает рендеринг в Blender 5.3 для кадров, анимаций и turntable. Включается для рендера кадра, анимации или turntable. CX Codex +1 582установок blender-geometry-nodes Скилл blender-geometry-nodes для Claude Code помогает собирать Geometry Nodes в Blender. Он включается при создании процедурных объектов, рассеивании экземпляров и настройке входов модификатора. CX Codex +1 563установок 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-workflow-recipes Скилл blender-workflow-recipes для Claude Code и Cursor собирает пайплайны для Blender 5.3 с этапами контроля качества и обработки моделей. Запускается на каждый запрос по многостадийной обработке активов. CX Codex +1 543установок 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установок

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

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